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COMPUTER EQUIPMENT AND SOFTWARE PURCHASED FROM A 
RADIO SHACK COMPANY-OWNED COMPUTER CENTER, RETAIL 
STORE OR FROM A RADIO SHACK FRANCHISEE OR DEALER AT ITS 
AUTHORIZED LOCATION 


LIMITED WARRANTY 


CUSTOMER OBLIGATIONS 


A. 


CUSTOMER assumes full responsibility that this Radio Shack computer hardware purchased (the 
‘“Equipment’’), and any copies of Radio Shack software included with the Equipment or licensed 
separately (the ‘‘Software’’) meets the specifications, capacity, capabilities, versatility, and other 
requirements of CUSTOMER. 

CUSTOMER assumes full responsibility for the condition and effectiveness of the operating 
environment in which the Equipment and Software are to function, and for its installation. 


RADIO SHACK LIMITED WARRANTIES AND CONDITIONS OF SALE 


A. 


For a period of ninety (90) calendar days from the date of the Radio Shack sales document 
received upon purchase of the Equipment, RADIO SHACK warrants to the original CUSTOMER that 
the Equipment and the medium upon which the Software is stored is free from manufacturing 
defects. THIS WARRANTY IS ONLY APPLICABLE TO PURCHASES OF RADIO SHACK EQUIPMENT 
BY THE ORIGINAL CUSTOMER FROM RADIO SHACK COMPANY-OWNED COMPUTER CENTERS, 
RETAIL STORES AND FROM RADIO SHACK FRANCHISEES AND DEALERS AT ITS AUTHORIZED 
LOCATION. The warranty is void if the Equipment’s case or cabinet has been opened, or if the 
Equipment or Software has been subjected to improper or abnormal use. If a manufacturing defect 
is discovered during the stated warranty period, the defective Equipment must be returned to a 
Radio Shack Computer Center, a Radio Shack retail store, participating Radio Shack franchisee or 
Radio Shack dealer for repair, along with a copy of the sales document or lease agreement. The 
Original CUSTOMER’S sole and exclusive remedy in the event of a defect is limited to the 
correction of the defect by repair, replacement, or refund of the purchase price, at RADIO 
SHACK’S election and sole expense. RADIO SHACK has no obligation to replace or repair 
expendable items. 

RADIO SHACK makes no warranty as to the design, capability, capacity, or suitability for use of 
the Software, except as provided in this paragraph. Software is licensed on an ‘‘AS IS’’ basis, 
without warranty. The original CUSTOMER’S exclusive remedy, in the event of a Software 
manufacturing defect, is its repair or replacement within thirty (30) calendar days of the date of the 
Radio Shack sales document received upon license of the Software. The defective Software shall 
be returned to a Radio Shack Computer Center, a Radio Shack retail store, participating Radio 
Shack franchisee or Radio Shack dealer along with the sales document. 

Except as provided herein no employee, agent, franchisee, dealer or other person is authorized to 
give any warranties of any nature on behalf of RADIO SHACK. 

Except as provided herein, RADIO SHACK MAKES NO WARRANTIES, INCLUDING WARRANTIES 
OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. 

Some states do not allow limitations on how long an implied warranty lasts, so the above 
limitation(s) may not apply to CUSTOMER. 


LIMITATION OF LIABILITY 


A. 


EXCEPT AS PROVIDED HEREIN, RADIO SHACK SHALL HAVE NO LIABILITY OR RESPONSIBILITY 
TO CUSTOMER OR ANY OTHER PERSON OR ENTITY WITH RESPECT TO ANY LIABILITY, LOSS 
OR DAMAGE CAUSED OR ALLEGED TO BE CAUSED DIRECTLY OR INDIRECTLY BY 
“EQUIPMENT” OR “‘SOFTWARE”’ SOLD, LEASED, LICENSED OR FURNISHED BY RADIO SHACK, 
INCLUDING, BUT NOT LIMITED TO, ANY INTERRUPTION OF SERVICE, LOSS OF BUSINESS OR 
ANTICIPATORY PROFITS OR CONSEQUENTIAL DAMAGES RESULTING FROM THE USE OR 
OPERATION OF THE “EQUIPMENT” OR ‘“‘SOFTWARE’’. IN NO EVENT SHALL RADIO SHACK BE 
LIABLE FOR LOSS OF PROFITS, OR ANY INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES 
ARISING OUT OF ANY BREACH OF THIS WARRANTY OR IN ANY MANNER ARISING OUT OF OR 
CONNECTED WITH THE SALE, LEASE, LICENSE, USE OR ANTICIPATED USE OF THE ‘‘EQUIPMENT”’ 


OR “SOFTWARE”. 
continued : 
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RADIO SHACK SOFTWARE LICENSE 


RADIO SHACK grants to CUSTOMER a non-exclusive, paid-up license to use the RADIO SHACK Software 
on one computer, subject to the following provisions: 


G. 


APPLICABILITY OF WARRANTY 
A. 


STATE LAW RIGHTS 


The warranties granted herein give the original CUSTOMER specific legal rights, and the original 
CUSTOMER may have other rights which vary from state to state. 
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NOTWITHSTANDING THE ABOVE LIMITATIONS AND WARRANTIES, RADIO SHACK’S LIABILITY 
HEREUNDER FOR DAMAGES INCURRED BY CUSTOMER OR OTHERS SHALL NOT EXCEED THE 
AMOUNT PAID BY CUSTOMER FOR THE PARTICULAR ‘‘EQUIPMENT’’ OR ‘‘SOFTWARE”’ 
INVOLVED. 

RADIO SHACK shall not be liable for any damages caused by delay in delivering or furnishing 
Equipment and/or Software. 

No action arising out of any claimed breach of this Warranty or transactions under this Warranty 
may be brought more than two (2) years after the cause of action has accrued or more than four 
(4) years after the date of the Radio Shack sales document for the Equipment or Software, 
whichever first occurs. 

Some states do not allow the limitation or exclusion of incidental or consequential damages, so the 
above limitation(s) or exclusion(s) may not apply to CUSTOMER. 


Except as otherwise provided in this Software License, applicable copyright laws shall apply to the 
Software. 

Title to the medium on which the Software is recorded (cassette and/or diskette) or stored (ROM) 
is transferred to CUSTOMER, but not title to the Software. 

CUSTOMER may use Software on one host computer and access that Software through one or 
more terminals if the Software permits this function. 

CUSTOMER shall not use, make, manufacture, or reproduce copies of Software except for use on 
one computer and as is specifically provided in this Software License. Customer is expressly 
prohibited from disassembling the Software. 

CUSTOMER is permitted to make additional copies of the Software only for backup or archival 
purposes or if additional copies are required in the operation of one computer with the Software, 
but only to the extent the Software allows a backup copy to be made. However, for TRSDOS 
Software, CUSTOMER is permitted to make a limited number of additional copies for 
CUSTOMER’S own use. 

CUSTOMER may resell or distribute unmodified copies of the Software provided CUSTOMER has 
purchased one copy of the Software for each one sold or distributed. The provisions of this 
Software License shall also be applicable to third parties receiving copies of the Software from 
CUSTOMER. 

All copyright notices shall be retained on all copies of the Software. 


The terms and conditions of this Warranty are applicable as between RADIO SHACK and 
CUSTOMER to either a sale of the Equipment and/or Software License to CUSTOMER or to a 
transaction whereby RADIO SHACK sells or conveys such Equipment to a third party for lease to 
CUSTOMER. 

The limitations of liability and Warranty provisions herein shall inure to the benefit of RADIO 
SHACK, the author, owner and/or licensor of the Software and any manufacturer of the Equipment 
sold by RADIO SHACK. 
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OS-9 Commands 
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OS-9 Operating System: ©1983 Microware Systems 
Corporation and Motorola Incorporated. 
All Rights Reserved. 
Licensed to Tandy Corporation. 


OS-9 Commands: 
©1983 Tandy Corporation 
and Microware Systems Corporation. 
All Rights Reserved. 


UNIX is a trademark of Bell Laboratories. 
TRS-80 is a registered trademark of Tandy Corporation. 


Reproduction or use, without express written permission from 
Tandy Corporation or Microware Systems Corporation of any 
portion of this manual is prohibited. While reasonable efforts have 
been taken in the preparation of this manual to assure its accuracy, 
Tandy Corporation and Microware Systems Corporation assumes no 
liability resulting from any errors or omissions in this manual, or 
from the use of the information contained herein. 
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Introduction 


This Manual is designed to acquaint you, with your OS-9 
Operating System. OS-9 greatly expands the capabilities of 
your TRS-80 Color Computer. 


OS-9 is based on the UNIX operating system, often 
acclaimed as the operating system of the future because of its 
versatility, unique structure, usefulness, and user-friendli- 
ness. UNIX is widely used on large computers, and now sys- 
tems like OS-9 bring UNIX’s clear advantages to owners of 
smaller computers. 


OS-9 was developed by the same people who designed the 
6809 microprocessor chip, the “‘heart’’ of the TRS-80 Color 
Computer. Unlike many other microprocessors, the 6809 is 
fully capable of running state-of-the-art software like OS-9. 
That kind of close compatibility is a real plus for the user. 


The OS-9 Operating System has many advanced features, 
which you’ll learn about in this manual. By the time you've 
finished reading and experimenting on your computer, you'll 
be familiar with, and ready to take advantage of OS-9 fea- 
tures like: 


@ Friendly user interface and environment 


@® Multi-user/multi-tasking realtime operating 
capabilities 


@ Extensive support for structural, modular 
programming 


® Device-independent interrupt-driven input/output 
system 


® Multi-level, fast random-access directory and 
file system 


@ Readily expandable and adaptable design 


We suggest that you read the manual chapter by chapter, ex- 
perimenting with OS-9’s features and commands as you go. 
But if you’re a computer veteran, and you feel you’re ready 
to begin using OS-9 without any further information about it, 
you can jump ahead to Chapter 6, “‘OS-9 COMMANDS”. 


Whether you’re a novice or a veteran you’ve made a wise 
choice with OS-9, and it won’t be long before you discover 
for yourself its many advantages. 
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1/Introduction to the Shell 


The ‘‘shell’’ is the part of OS-9 that accepts commands from 
the keyboard. It’s designed to provide a convenient, flexible, 
and easy-to-use interface between you and the powerful func- 
tions of the system. 


You automatically enter the shell each time you start up 
OS-9. When you see the ‘“‘OS-9:’’ prompt, that means the 
Shell is active and waiting for input — for your commands 
through the keyboard. 


Note: It doesn’t matter whether you use upper-case or 
lower-case letters — or a combination of both — in 
your commands; OS-9 recognizes and handles both. 


1.1 Command Structure 


Commands — which are really programs for the computer to 
run — can include one or more words, but they always begin 
with the name of a program. The program can be one of a 
number of things, for instance: 


@ The name of a machine language program on disk. 
(Applies to experienced users, too, you’ll almost al- 
ways use commands from the OS-9 disk. OS-9’s 
commands are listed and explained in Chapter 6.) 


@ The name of a machine language program already in 
memory. 


@ The name of an executable program compiled by a 
high-level language like BASICO9, Pascal, or C (See 
Section 3.8.) 


@ The name of a procedure file. (See Section 3.6.) 


When OS-9 receives a command, the shell searches for the 
appropriate program in this sequence: 


1. Memory. 


2. The ‘‘execution directory’’, which contains OS-9’s 


command programs. (OS-9’s execution directory is 
usually CMDS.) 


3. The user’s ‘“‘data directory’’, in which the user can 
store program files as well as text files. When OS-9 
processes a file from the data directory, it runs it as 
a procedure file, assuming that the file contains 
several commands, or procedures. OS-9 will run 
them sequentially, just as if the commands had been 
manually typed in one by one. 


As soon as OS-9 locates the program, it runs it. 


Command Parameters 


The program specified in the command can be followed by 
one or more ‘‘parameters’’, variables which give the compu- 
ter more specific instructions to follow. OS-9 automatically 
passes the parameters to the program called up by the shell 
when you enter your full command line. For example, in the 
command line: 


list filei (ENTER 


List is the name of a program that displays the contents of a 
text file, and filel — the specified parameter — is the name 
of the file whose contents are to be displayed. 


Note: Parameters are always separated from the com- 
mand line, and from each other, by spaces; therefore 
parameter names themselves cannot contain spaces. 
Chapter 6 discusses parameters for each of OS-9’s 
commands. 


Some commands have more than one parameter. For in- 
stance, the Copy command makes an exact copy of a file. It 
requires two parameters: the name of the file to be copied, 
and the name of the file that will be the copy. So if you want 
to copy a file called startup, and call the copy newstartup, 
your command line reads: 


COPY StartuP newstarturp (CENTER 


Other parameters let you select built-in command options. 
For instance, the Dir command by itself simply shows the 
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name of all files in the user’s current data directory — the 
directory in which the user is positioned when giving the 
command. 


But if you add the e (for ‘‘entire’’) option as a parameter, like 
this: 


dir e (ENTER 


then the output includes not only the names of the files, but 
also complete statistics about each file — the date and time 
created, size, security codes, and so forth. 


The Dir command can also accept as a parameter the name of 
a particular directory on the system. For example, the com- 
mand line: 


dir SYS (ENTER 


produces a list of all files in the SYS directory. And the com- 
mand line: 


dir SYS e (ENTER 
gives complete information about each file in SYS. 
dir SYS e >/P (ENTER 


gives complete information about each file in SYS and re- 
directs it to the printer. 


Note: A command line can also include one or more 
‘*modifiers’’ — specifications used by the shell to alter 
the program’s standard input/output files or memory 
assignments. (See Chapter 3.) 


1.2 Common Command Formats 


This section includes examples of command formats most 
commonly used with OS-9, and examples of how each com- 
mand might look as it’s entered into the computer. Para- 
meters in brackets are optional; others are necessary parts of 
the command. 


FORMAT: — chd DIRECTORY NAME 
EXAMPLE: chd /D@®/SYS (ENTER 


Moves the user from the current working directory into the 
directory specified as a parameter, in this case /DO/SYS. 


FORMAT: makdir DIRECTORY NAME 
EXAMPLE: makedir /D@/EMPLOYEES (ENTER 


Creates a new directory, in this case called /DO/EM- 
PLOYEES. You’ll often want to follow this command with a 
Chd command to make the new directory your current work- 
ing directory. 


FORMAT: — pwd (ENTER 
EXAMPLE: /D@/BUSINESS/PAYROLL 


Shows the full path from the directory PAYROLL, to the 
current working directory. 


FORMAT: | dir /DO/[filename] [e] [x] 
EXAMPLE: dir PAYROLL e (ENTER 


Lists the names of all files contained in the current working 
directory if you don’t specify another. In this case, the 
PAYROLL directory is specified. The e option gives com- 
plete statistics about each file in the directory. The x option 
lists files in an execution directory rather than a data 
directory. 


Note: When you’re using a command that affects direc- 
tories — and Chd, Makdir and Dir are good examples 
— make sure you specify the name of a directory and 
not a single file; otherwise, the command won’t work. 
Remember: a file contains lines of text or a single pro- 
gram, and a directory is a collection of files and sub- 
ordinate directories. 


FORMAT: copy filename! filename 2 


EXAMPLE: cory memos newmemos (ENTER 
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Creates a new file — in this case newmemos — and then 
copies all data from memos. into it. The original file isn’t 
affected. 


FORMAT: del filename 

EXAMPLE: del letters 
Deletes — destroys — the specified file. 
FORMAT: _ free DEVICENAME 
EXAMPLE: free /Di 


Shows how much free space remains on the specified device, 
in this case the disk on drive 1. 


FORMAT: _ list filename 
EXAMPLE: list Junk (ENTER 


Displays on the terminal the contents — the text — of the 
specified file. 


FORMAT: | rename filename! filename2 
EXAMPLE: rename stuff miscellany (ENTER 


Changes the name of a file. In this case, the file formerly 
called stuff is now named miscellany. 


1.3 Using the Video Display and Keyboard 


OS-9 has many features which expand the capability of the 
Color computer’s video display and keyboard. With OS-9, 
for instance: 


@ The video display has upper/lower case, screen 
pause, and graphics functions. 


@ The keyboard can generate all ASCII characters. 
(Appendix C lists all characters and codes you can 
generate from the keyboard.) 


@ The keyboard has a type-ahead feature that lets you 
enter data before it’s requested by a program. But, 
only if the disk drives are not being accessed by a 
program. 


@ The video display and keyboard together can be dealt 
with as a file. OS-9 refers to them as a file called 
/term. 


Video Display Functions 


The Color Computer normally uses only upper-case letters. If 
you want lower-case letters (for instance, if you’d like to be 
able to send them to the printer), you can turn off the upper- 
case function with a command called tmode -upc. You then 
see lower-case letters represented on the screen in reverse 
video (try Dir as an example) — green letters on a black 
background instead of the usual black letters on a green back- 
ground. To return to all upper-case letters, use the command 
tmode upc. 


Note: See the Keyboard Shift and Control Functions 
section for important information about shift lock 
behavior. 


The display’s screen pause feature stops programs after they 
display 16 lines. Press any key to continue program output. 
You can turn screen pause off and on by using, respectively, 
the tmode -pause and tmode pause commands. 


The display system also has a complete set of commands to 
emulate commercial data terminals, plus a complete set of 
graphics commands. (They’re described in detail in Appendix 
B.) 


Keyboard Shift and Control Functions 


With OS-9, several Color Computer keys have new and use- 
ful functions. 


The key works something like its counterpart on a 
typewriter, letting you select upper-case or lower-case charac- 
ters. The shift lock function, which affects only letter charac- 
ters, is normally on, producing upper-case letters. To obtain a 
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lower-case letter when the shift lock is on, use the (SHIFT 
key. 


To turn off the shift lock function, press and (0) 
simultaneously. Then your keyboard generates lower-case 
characters, and, if you want upper-case, you use the 
key. Again pressing and (0) simultaneously turns the 
shift lock back on. 


Note: The tmode upc function affects shift lock be- 
havior. When you’re in the upc mode, upc overrides 
both the key and the shift lock function, and 
you get only upper-case characters. In order for the 
key and lock function to work, you should be 
in -upc. 


Several key combinations, when pressed simultaneously, 
generate ‘‘control functions’’ from the keyboard. The 
(0) combination, which reverses shift lock state, is a good 
example. Other control functions, and the key combinations 
that generate them, include: 


(A) — Repeats previous input line. Displays, 
but doesn’t process, the last line entered, and posi- 
tions the cursor at the end of the line. Press 
to enter the line, or edit the line by backspacing. If 
you edit, you can press (A) again to display 
the edited line. 


CLEAR) (D) — Redisplays present input on the next 
line. 


CLEAR) CW) — Temporarily halts output to the display 
so you can read the screen before the data scrolls 
off. Press any single key to resume output. 


CLEAR) CE) — Stops the current running program. (The 
BREAK) key performs the same function.) 


— Interrupts the video display of a run- 
ning program, reactivating the shell while the pro- 
gram runs as a background task. This function is 
often referred to as CONTROL C. 


— Sends an end-of-file message to 
programs that read input from the terminal instead of 
from a disk. Often referred to as the ESCAPE func- 
tion, this key combination must be the first character 
on a line in order to be recognized. 


— Deletes the entire current line. This 
function is often referred to as CONTROL X. The 
(+) alone, which backspaces and erases single char- 
acters, is commonly known as CONTROL H. 


NOTE: The (CLEAR) key is used as a control key by 
OS-9. Thus, if you wanted to send a CONTROL Q 
function, you would press (CLEAR) (Q) simultaneously. 


1.4 Sending Output to the Printer 


Most commands and programs normally send their output to 
the Color Computer’s video display. But if you want output 
to be printed, add this at the end of a command line: 


eEF 


The ‘‘>’’ character tells the shell to redirect output to the 
printer through the Color Computer’s RS-232 serial I/O port, 
which has the device name ‘‘/P’’. 


If for example, you want the output from the Dir command to 
go to the printer, type: 


dir 2/P (ENTER 


Technical Information for the RS-232 Port 


The RS-232 port can be operated at all standard baud rates, 
from 110 baud to 2400 baud. (The default speed is 600 
baud.) The character format used is | start bit, 8 data bits (no 
parity), 1 stop bit. 


You can use the Xmode command to set the port’s baud rate, 
end-of-line delay, auto line feed, and so forth. To examine 
the printer’s current settings, type: 
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xmode /P (ENTER 


Then, if you want to make changes, use the Xmode command 
and information from this chart: 


Baud Rate Code 
110 0 
300 l 
600 2 
1200 3 
2400 4 


If you want, for instance, to set the port to 1200 baud, and 
the end-of-line delay (null count) to 4 character times, type: 


xmode /P baud=3 mull=d (ENTER 
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2/The OS-9 File System 


This chapter gives you information about some of the most 
important elements of the OS-9 system. It acquaints you with 
the ways in which OS-9 deals with input and output, and with 
the structure and characteristics of the entire OS-9 file 
system. 


2.1 The Unified Input/Output System 


OS-9 has a unified input/output system in which data trans- 
fers to all I/O devices are performed in almost exactly the 
same way, regardless of the particular hardware devices 
involved. 


It might seem that the different operational characteristics of 
the I/O devices would make this difficult: after all line print- 
ers and disk drives behave very differently. However, OS-9 
overcomes most of these differences by defining a set of stan- 
dardized logical functions for all devices and by making the 
devices conform to these conventions, using software routines 
to eliminate hardware dependencies wherever possible. The 
result: a much simpler and more versatile input/output 
system. 


OS-9’s unified I/O system is based on logical entities called 
‘‘1/O paths’’. Paths are, in effect, *‘software channels’’ that 
can be routed from a program to a disk to any other I/O 
device, or even to another program. 


Data transferred through paths is processed by OS-9 to con- 
form to the hardware requirements of the specific I/O device 
involved. Data transfers can be either bidirectional (read/ 
write) or unidirectional (read only or write only), depending 
on the device and/or how you establish the path. 


Data transferred through a path is a stream of 8-bit binary 
bytes that have no specific type or value: what the data 
actually represents depends on how it’s used by each pro- 
gram. This is important because it means that OS-9 doesn’t 
require data to have any special format or meaning. 
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Some of the advantages of OS-9’s unified I/O system are: 


® Programs will operate correctly regardless of the par- 
ticular I/O devices selected and used when the pro- 
gram is actually executed. 


@ Programs are highly portable from one computer to 
another, even when the computers have different 
kinds of I/O devices. 


@ I/O can be redirected to alternate files or devices 
when the program is run, without having to alter the 
program. 


@ New or special device-driver routines can easily be 
created and installed by the user. 


2.2 Organization of the File System 
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Disks are multifile devices that store data — both text and 
programs — in separate logical entities called files. OS-9 
handles files in a number of ways designed to help you orga- 
nize information easily and well. 


For instance, with OS-9, groups of files can be collected into 
directories, much as in an office file folders pertaining to a 
particular subject can be gathered into a file cabinet drawer. 
Directories can in turn be collected into larger directories, just 
as several file cabinet drawers are gathered into a single file 
cabinet, and so forth. With OS-9, you can have a virtually 
limitless number of directory levels, with each directory con- 
taining other directories and/or files. 


When you’re working with OS-9’s files and directories — 
both the ones that come built in to the system and the ones 
you create it’s important to remember this multi-level 
‘*hierarchical’’ organization. 


In effect, it lets you build an upside-down tree, branching out 
as you go down. That way, each user on your system can 
privately organize material without affecting anyone else’s 
material. You can organize your own material in particularly 
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useful ways. And both the system itself and its users can 
easily locate stored material. 


An OS-9 System Disk contains names of, and linkages to, all 
system I/O entities in the hierarchy. For-example, a typical 
System Disk, diagrammed partially and simply, might look 
like this: 


System Device Directory 


P DO TERM D1 TI 
| DO Root ane D1 Root Directory 
DEFS startup CMDS PAYROLL MEMOS 
OS-9Defs SALES ACCOUNTING 
copy list dir del chris 


HOURLY SALARIED 


Aa. Be 2 Se. ee 


Note: It’s customary to capitalize directory names and 
to use lower-case for file names; that way, you can tell 
at a glance what’s a directory and what’s a file. 


In the diagram, P is the printer; DO is the first disk drive; 
TERM is the keyboard and video display; D1 is a second disk 
drive; and T1 is the Color Computer’s RS-232 serial port. 


The ‘‘root directory’’ of DO — the ‘‘root’’ from which the 
rest of the disk’s file system ‘‘grows’’ — contains a file 
called startup and two other directories, DEFS and CMDS. 


Those directories, in turn, contain files — DEFS contains a 
file called OS-9Defs and CMDS contains four files: copy, 
list, dir, and del. All these files and directories — and many 
more — come built in to the OS-9 system. 


The system diagrammed here also has a second disk, with its 
own root directory. (Root directories are automatically cre- 
ated when you initialize a disk using the format command.) 
Here the user has created directories called PAYROLL and 
MEMOS. PAYROLL, in turn, contains two other directories, 
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Names 


Pathlists 
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each of which contain two files. The MEMOS directory con- 
tains two directories, one of which contains a file. 


Each file, directory, and physical I/O device on the system — 
whether it’s built in or added by you — has its own name. 
When you’re doing the naming, there are several things to 
keep in mind. 


Names can include from | to 29 characters, all of which are 
used for matching. Each name must begin with an upper- or 
lower-case letter, followed by any combination of the follow- 
ing characters: 


@ Upper-case letters (A-Z) 
@ Lower-case letters (a-z) 
@ Decimal digits (0-9) 

@ Underscoring (_) 

@ Period (.) 


Some legal names, therefore, are: 


raw.data.2 

REPORTS 

Ak 

project — review.backup 
RJJONES 

M101968 


File and directory names like the following ones are not legal: 


19OCTOBER (because it doesn’t begin with a letter) 


max*min (because * isn’t a legal character for 
names) 
.DATA (because it doesn’t begin with a letter) 


open orders (because a name can’t contain a space) 


When you want to access anything on the system — to open 
a path — you have to give OS-9 a description of the routing 
of the path. You provide the information in the form of a 
‘‘pathlist’’, a list of names from the root directory down to 
the file you want to access. 
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Device Names 


If, for instance — again using the diagram — you want to 
access the chris file on the disk in Drive 1, you construct a 
pathlist by reading from the root directory to the file, listing 
the ‘‘stops along the way’’, and separating them with slashes, 
like this: 


/D1/MEMOS/SALES/chris 


OS-9 uses the pathlist sequentially, from left to right, to de- 
termine that the file you want is on Device D1, in the 
MEMOS directory, in the SALES (sub)directory; and that its 
name is chris. 


OS-9’s hierarchical organization and pathlist convention help 
you access what you need quickly and efficiently — and also 
mean that you can, if you want, have two files of the same 
name, as long as they’re in separate directories; that way, of 
course, their pathlists are different. 


Note: Under some circumstances, you can take a 
‘‘shortcut’’ to a file, directory, or device name. See 
Working Directories in Section 2.3. 


Each physical I/O device supported by the system has a 
unique name, defined when the system is set up and un- 
changeable while the system is running. Most of the device 
names used for the Color Computer are on the diagram. But 
in addition to P, DO, TERM, D1, and T1, the Color Compu- 
ter also uses PIPE. 


Device names can be used only as the first part of a pathlist, 
since they’re at the root of the file system. In any pathlist, 
always precede the name of a device with a slash. 


When you’re referring to a non-disk device — a terminal or 
printer, for example — use only the device name: /P, for 
instance, is the full allowable pathlist for a printer. 
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2.3 Directories 


Using Directories 
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Note: I/O device names are actually the names of the 
device descriptor modules OS-9 keeps in an internal 
structure called the module directory. (See the OS-9 
Technical Information manual for more information.) 
The module directory is automatically set up during the 
OS-9 startup sequence, and is updated as modules are 
added or deleted while the system is running. 


On OS-9, directories, which are collections of files, are in 
reality themselves files — ‘‘superfiles’’, but still files — and 
are processed by the same I/O functions used with regular 
files. 


To understand how directories work, assume that the disk in 
drive one (*‘/D1’’) is freshly formatted so that it has only a 
root directory. You can use the Build command to create a 
test file you call filel on /D1. Build prints out °*‘?’’ as a 
prompt to indicate that it’s waiting for you to enter a text 
line. It places each line into the text file until you enter an 
empty line with only a carriage return, like this: 


build /OL/Tilel 

7 This is the first file that (ENTER) 
? we're creating. (ENTER 

* (ENTER 


If you use the Dir command, which lists the files in a direc- 
tory, it now indicates the existence of the new file: 


dir /Di (ENTER 
Directory of 701 13905 4225 
filel 


You can use the list command to display the text stored in the 
file: 


eeeeeeeoeooeoeoooooaooeo eo oo oeooaooeoeoe eo eee eee € 


POOOSSOSOSOOSOOSOOOOOOSCCCOCCCCCCCOECCCC®S 


list /Di/filel (ENTER 


This is the first file 
that we’re creating, 


Suppose you again use the build command to create two 
more text files: 


build /Di/filez (CENTER 

? This is the second file (ENTER) 
° that we’re creating. (CENTER 

* (ENTER 


build /Di/fileS (ENTER 
* This is another file. (ENTER 
(ENTER 


Now if you use the Dir command: it shows 
three file names: 


dir /Di1 (ENTER 
DL Peorea ts oF 7° De 1 ea eee et 
T2467 filez files 


Creating Directories 


To create a directory on the system, use the Makdir com- 
mand. With Makdir, you can create a virtually unlimited 
number of directories on a disk. 


Suppose that for now you want to create in the /D1 root 
directory a new directory called NEWDIR. You type: 


makdir /DI/NEWDIR (CENTER 


and the new directory is automatically part of the /D1 root 
directory. You can check it using Dir: 


dir /Di (ENTER 


Directory ef 02 L640 S34 
filel filee2 files 
NEWDIR 

Now suppose you want to create a new file — a copy of 


filel. You want to call filel.copy, for instance — in the new 
directory. Use the Copy command, like this: 
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cory /D1i/filel/DI/NEWDIR/filel. 
cory (ENTER 


Note, that the second pathlist now has three names: the name 
of the root directory (/D1), the name of the next lower direc- 
tory in the hierarchy (NEWDIR), and then the actual filename 
(filel.copy). Here’s what the structure looks like now: 


D1 Root Directory 


fe re ee) 
NEWDIR file] file2 file3 
filel .copy 


You can use Dir command to see the name of the file in the 
new directory: 


dir /DiI/NEWDIR (ENTER 


Directory of /DI/NEWDIRN iSB¢29:29 
filel.copy 


It’s possible to use Makdir to create additional new direc- 
tories in NEWDIR, and so on. Your only limit is disk space 
availability. 


Note: A file and the directory it’s in must reside on the 
same device. That is, all the elements in a single path- 
list must be on the same disk. 


Deleting Directories 


To delete a directory, it’s first necessary to remove all the 
files it contains. If you delete a directory while it still con- 
tains files, OS-9 has no way — no path to access those files, 
or to return their storage to the storage pool. 


Deleting a directory involves three steps: 


1. Deleting all files in the directory with the del 
command. 


2. Using the Attr command to reverse the directory 
attribute, turning the directory into a regular file. 
(See Section 2.4, The File Security System.) 
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3. Deleting the former directory — now a regular file 
— using the Del command. 


It’s not a difficult process, but there’s an easier way: use the 
Deldir command to perform all three steps automatically. 


Working Directories 


When you’re using OS-9, you’re always associated with two 
directories: a ‘‘data directory’’ and an “‘execution directory.’’ 
While you’re using them, they’re known as your ‘‘working”’ 
or ‘‘current’’ directories. The double association allows pro- 
gram files — executable files — to be organized separately 
from data files. 


Immediately after startup, OS-9 sets the data directory to be 
the root directory of the system disk drive (usually /DO) and 
the execution directory to be the built-in CMDS directory on 
the same drive. 


Note: On timesharing systems, the Login command 
selects the user’s initial data and execution directories 
according to specifications in the system password file. 


While you’re on the system, OS-9 automatically selects one 
or the other of your two working directories, depending on 
the usage of the pathlist: 


@ It searches the execution directory when it attempts 
to run or to load into memory files assumed to be 
executable programs. (This means that programs to 
be run as commands or loaded into memory must be 
in the execution directory. ) 


@ It uses the data directory for all other references, 
such as text files. 


Using Working Directories. Knowing about working direc- 
tories — current directories — can let you take “‘shortcuts’’ 
as you write out pathlists, and lets OS-9 find what you want 
more quickly: 


@ If the command you’re using relates to a file or a 
device not in your working directory, or in your 
working directory but above you in the hierarchy, 
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it’s necessary to use a complete pathlist, starting at 
the root, for instance with /DO or /D1. 


® But if you’re trying to access a file or device within 
your working directory, below you on the hierarchy, 
you can start your pathlist immediately below your 
working directory; the rest of the pathlist is implied. 


For example, if your current data directory begins with /DO, 
and you want to reach a file called baseball in the directory 
whose root is /D1, you use its full pathlist, which might be: 


/D1/PETE/GAMES/baseball 
in your command line. 


But if your current data directory is /D1/PETE/GAMES and 
you want to access baseball, you simply include in your com- 
mand the filename: 


baseball 


The full pathlist is implied, and processing begins with your 
current data directory. 


Pathlists using working directories can also specify additional 
lower-level directories and files. For instance, if your current 
directory is still /D1/PETE/GAMES, you can type: 


ACTION/ racing 
in your command line, and this pathlist is implied: 
/D1/PETE/GAMES/ACTION/racing 


If your current execution directory is /DO/CMDS, and your 
current data directory is /DO/JONES, and you type 


copy filel fileZ (ENTER 


as your command line, in its search OS-9 expands both im- 
plied pathlists to their fullest. Written out completely, they 
look like this: 


/DO/CMDS/copy /D0/JONES/file1 /D0/JONES/file2 
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Changing Working Directories. You can make any direc- 
tory for which you have access permission your working 
directory. The built-in shell commands Chd and Chx indepen- 
dently change the current data directory and the current exe- 
cution directory, respectively. 


Follow the Chd and Chx commands with a pathlist that de- 
scribes the new directory to which you want to go. If your 
pathlist begins with a device name, OS-9 will begin its search 
at the device directory level — up at the root. Otherwise, its 
search will start at the current directory. 


For instance, suppose your current data directory is /DO/ 
JOHN and you want to make /D1/MY.DATAFILES your 
current data directory. Type: 


chd/Di/MY.DATAFILES (ENTER 


But if you’re already in /D1/MY.DATAFILES, and you want 
to move to a subdirectory called FEB.FILES, then you simp- 


ly type: 
chd FEGsFILES CENTER 


and the full pathlist — /D1/MY.DATAFILES/FEB.FILES — 
is implied. Use the Chx command in exactly the same way 
you use Chd. 


Anonymous Directory Names. Sometimes it’s useful to be 
able to refer to your current directory, or to a higher-level 
directory, but you may not know the full pathlist to use. Or 
you may want merely to save typing time. 


In either case, OS-9 makes special ‘‘name substitutes’’ 
available: 


@6 3:3 


@ The name refers to the current directory 


@ The name ‘‘..’’ refers to the ‘‘parent’’ of the current 
directory (the next highest-level directory in the path) 


@ The name “‘...’’ refers to the directory two levels up, 
and so on 


You can use the names in place of pathlists and/or as the first 
names in pathlists. Some examples: 
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dir . (ENTER 

lists filenames in the current data directory. 
dir .+ (ENTER 

lists names in the current data directory’s parent directory. 
del ../teme 


deletes the file called temp from the current data directory’s 
parent directory. 


The substitute names refer to either the execution or data 
directories, depending on the context in which the names are 
used. For example, if ‘‘..’’ is used in a pathlist of a file 
which is executable, it represents the parent directory of the 
execution directory. Similarly, if *‘.’’ is used in a pathlist 
describing a program’s input file, it represents the current 
data directory. 


2.4 The File Security System 
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Every file and directory has properties called ‘*‘ownership’’ 
and ‘‘attributes’’, which determine who may access the file 
and how it may be used. 


OS-9 automatically stores with each file the user number 
associated with the process that created it. This user is consi- 
dered to be the owner of the file. 


Usage of security functions are based on attributes that define 
how and by whom the file can be accessed. There are a total 
of eight attributes, each of which can be turned ‘‘off’’ or 
‘‘on’’ independently. When the ‘‘d’’ attribute is on, it indi- 
cates that the file is a directory. The ‘‘s’’ attribute means that 
the file is sharable — that more than one program can read 
from the file at the same time. 


The other six attributes control whether the file can be read, 
written to, or executed, by either the owner or the ‘‘public’’ 
(all other users). Specifically, these six attributes are: 
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Write permission for owner: If it’s on, the owner may 
write to the file or delete it. This permission can be 
used to protect important files from accidental deletion 
or modification. 


Read permission for owner: If it’s on, the owner is 
allowed to read from the file. This can be used to pre- 
vent ‘‘binary’’ files from being used as ‘‘text’’ files. 


Execute permission for owner: If it’s on, the owner 
can load the file into memory and execute it. The file 
must contain one or more valid OS-9-format memory 
modules in order to be loadable. 


Write permission for public: If it’s on, any other user 
may write to or delete the file. 


Read permission for public: If it’s on, any other user 
may read (and possibly copy) the file. 


Execute permission for public: If it’s on, any other 
user may execute the file. 


For example, if a particular file has all permissions on except 
‘‘write permit to public’’ and ‘‘read permit to public’’, the 
owner has unrestricted access to the file, and other users can 
execute it, but not read, copy, delete, or alter it. 


Examining and Changing File Attributes 


You can use the Dir command, with the e (entire) option, to 
examine the security permissions of all files in a particular 
directory. An example of output from the Dir e command 
used on the current data directory is: 


Directory of .« 10:20:44 


Owner Last Modified Attributes Sector Bytecount Name 
1 83/05/29 1402 -~-e--e-TFr 47 42 filel 
@ 83/10/12 @215 ---WI-Wr 48 43 file2 
a 83/04/29 2335 -S----Wr o1 22 file3 
1 83/01/06 1619 d--wr-wr 6D Bae NEWDIR 


The ‘‘Attributes’’ column shows which attributes are current- 
ly on by the presence or absence of particular characters in 
this format: 
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dsewrewr 


The character positions correspond, from left to right, to: 
directory, sharable, public execute, public write, public read, 
owner execute, owner write, owner read. 


Use the Attr command to examine or change the attributes of 
a particular file. Typing Attr followed by a filename shows 
you a file’s current attributes, for example: 


attr filez2 (ENTER 
-S-WreWwr 


Reading the attributes from left to right, you can see that 
file2: is not a directory; is sharable; can’t be executed by the 
public but can be written to and read by the public; and can 
be executed, written to, and read by its owner. 


If you use Attr and a filename followed by a list of one or 
more attribute abbreviations, the file’s attributes will be 
changed accordingly (if, of course, it’s legal for you to make 
the changes). For instance the command: 


attr file2S pw pr -e -pe (ENTER 


enables public write and public read permissions and removes 
execute permission for both the owner and the public. 


Note: The d attribute behaves somewhat differently 
from the other attributes, in order to protect data stored 
in directories. You can’t use Attr to turn on the d attri- 
bute — only Makdir can do that — and you can use 
Attr to turn d off only if the directory is empty. 


2.5 Reading and Writing from Files 
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OS-9 uses single type and format for all files, each of which 
stores an ordered sequence of 8-bit bytes. OS-9 isn’t usually 
sensitive to the contents of files for most functions. A given 
file can store a machine language program, characters of text, 
or almost anything else. Data is written to and read from files 
exactly as it’s given. The file can be any size, from zero up 
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File Usage in OS-9 


to the maximum capacity of the storage device, and can be 
expanded or shortened as desired. 


When a file is created or opened, a ‘“‘file pointer’’ is estab- 
lished for it. Bytes within the file are addressed like memory, 
and the file pointer holds the ‘‘address’’ of the next byte in 
the file to be written to or read from. The OS-9 ‘‘read’’ and 
‘“write’’? service functions always update the pointer as data 
transfers are performed, so that successive read or write op- 
erations perform sequential data transfers. 


If you’re an advanced user of the system, and particularly if 
you’re using high-level languages, OS-9 is even more versa- 
tile than usual. There are certain functions that allow you to 
reposition the file pointer. 


To expand a file, you can simply write past the previous end 
of the file. Reading up to the last byte of a file causes the 
next read request to return an end-of-file status. 


Even though there is physically only one type of file, the 
logical usage of files in OS-9 covers a broad spectrum. Be- 
cause all OS-9 files have the same physical type, you can use 
commands such as Copy, Del, and so forth, with any file, 
regardless of its logical usage. Similarly, a particular file can 
be treated as having different logical usages at different times 
by different programs. The main usages of files discussed 
here are: 


@ Text 

@ Random access data 

@ Executable program modules 
@ Directories 

@ Miscellaneous 


Text Files. These files contain variable-length sequences — 
lines — or ASCII characters. Each line is terminated by a 
carriage return character (ASCII code OD or decimal 13). 


Text files are used for program source code, procedure files, 
messages, documentation, and many other purposes. The 
Text Editor operates on this file format. 
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Text files are usually read sequentially, and are supported by 
almost all high-level languages (such as BASICO9 read and 
write statements). Even though it’s possible to randomly ac- 
cess data at any location within a text file, it’s rarely done in 
practice because lines vary in length and it’s hard to locate 
the beginning of each line without actually reading the data to 
find carriage return characters. 


You can examine the content of text files by using the List 
command. 


Random-Access Data Files. Random-access data files are 
created and used primarily from within high-level languages 
like BASICO9, Pascal, C, and Cobol. In BASICO9 and Pas- 
cal, get, put, and seek functions operate on random-access 
files. 


Each file is organized as an ordered sequence of records. 
Each record is exactly the same length, so if a record’s 
numerical index is given, the record’s beginning address 
within the file can be computed by multiplying the record 
number by the number of bytes used for each record. Records 
can, therefore be directly accessed in any order. 


In most cases, the high-level language allows each record to 
be subdivided into fields. Each field generally has a fixed 
length and usage for all records within the file. For example, 
the first field of a record may be defined as being 25 text 
characters, the next field may be two bytes long and used to 


hold 16-bit binary numbers, and so on. 


It’s important to understand that OS-9 itself doesn’t directly 
process or deal with records other than by providing the basic 
file functions required by all high-level languages to create 
and use random-access files. 


Executable Program Module Files. These files are used to 
hold program modules generated by the assembler or com- 
piled by high-level languages. Each file can contain one or 
more program modules. 


OS-9 program modules resident in memory have a standard 
module format that, besides the object code, includes a 
‘‘module header’’ and a CRC check value. Program modules 
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stored in files contain exact binary copies of the programs as 
they’ll exist in memory, and not one byte more. Unlike many 
other operating systems, OS-9 doesn’t require a ‘‘load record”’ 
system because OS-9 programs are position-independent and 
therefore don’t have to be loaded into specific memory 
addresses. 


In order for OS-9 to load the program module(s) from a file, 
the file itself must have execute permission set, and each 
module must have a valid module header and Cylic Redun- 
dancy Checksum (CRC) value. If a program module is altered 
in any way, either as a file or in memory, its CRC check 
value is incorrect and OS-9 refuses to load the module. The 
verify command can check the correctness of the CRC 
values, and update them to corrected values if necessary. 


If a file has two or more modules, they’re treated as indepen- 
dent entities after loading and they reside at different memory 
regions. 


If you attempt to use the List command on program files, or 
any other files that contain binary data, the result is a jumbled 
display or random characters and effects. Use the Dump com- 
mand to safely examine the contents of this kind of file in 
hexadecimal and controlled ASCII format. 


Directories. Directories — which are, in effect, ‘‘superfiles’’ 
— play a key role in the OS-9 file system. Section 2.3 of this 
chapter describes how they’re used by various OS-9 features. 
Directories can be created only by the Makdir command, and 
can be identified by the d attribute. 


Each directory is organized into 32-byte records. Each record 
can be an entry in the directory. The first 29 bytes of the 
record is a string of characters that is the file name. The last 
character of the name has its sign bit (most significant bit) 
set. If the record isn’t in use, the first character position has, 
the value zero. The last three bytes of the record is a 24-bit 
binary number that’s the logical sector number where the file 
header record is located. 


The Makdir command initializes all records in a new direc- 
tory to be unused entries except for the first two entries. 
These entries have the names ‘‘.’’ and ‘‘..’’ along with ‘the 
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logical sector numbers of the directory and its parent direc- 
tory, respectively. 


The commands Copy and List won’t work with directories, 
Instead, use Dir. Directories also can’t be deleted directly, 
but must first be emptied and turned into regular files. 


Miscellaneous File Usage. OS-9’s basic file functions are so 
versatile that it’s possible to devise an almost unlimited num- 
ber of special-purpose file formats for particular applications, 
formats which don’t fit into any of the categories discussed 
here. 


Examples of special file usage include COBOL Indexed Se- 
quential (ISAM) files and some special word processor file 
formats which allow random access of text lines. As men- 
tioned earlier most OS-9 utility commands work with any file 
format, including these special types. In general, the Dump 
command is the preferred method for examining the contents 
of unusually formatted files. 


Physical File Organization 


28 


OS-9’s file system implements universal logical organization 
for all I/O devices that effectively eliminates most hardware- 
related considerations for most applications. This section 
gives basic information about the physical file structure used 
by OS-9. (For more information, see the OS-9 Technical In- 
formation manual.) 


Each OS-9 file comprises one or more “‘sectors’’, which are 
the physical storage units of disk systems. Each sector con- 
tains 256 data bytes. Disks are numbered sequentially starting 
with sector 0, track 0. This number is called a “‘logical sector 
number’’, or LSN. The mapping of logical sector numbers to 
physical track/sector numbers is done by the disk driver 
module. 


A sector is the smallest allocatable physical unit on a disk 
system. However, to increase efficiency on some larger- 
capacity disk systems, OS-9 uses uniform-sized groups of 
sectors, called ‘‘clusters’’, as the smallest allocatable unit. 
Cluster sizes are always an integral power of two (2, 4, 8, 
and so on.) One sector of each disk is used as a bitmap 
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(usually LSN 1), in which each data bit corresponds to one 
cluster on the disk. The bits are set and cleared to indicate 
which clusters are in use, which are defective, and which are 
free for allocation to files. 


The Color Computer disk system uses this format: 


@ Double-density recording on one side 
@ 35 tracks per disk 

@ 18 sectors per track 

@ One sector per cluster 


On OS-9, each file has a directory entry which includes the 
filename and the logical sector number of the file’s ‘‘file de- 
scriptor sector’’, which contains a complete description of the 
file, including: 


® attributes 

@ owner 

@ date and time created 

@ size . 

@ segment list (description of data sector blocks) 


Unless the file size is zero, the file will have one or more 
sectors/clusters used to store data. The data sectors are 
grouped into one or more contiguous blocks called 
*“segments.’’ 
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3/Advanced Features Of The Shell 


Chapter 1 of this manual introduced basic shell functions and 
commands. This chapter discusses the more advanced 
capabilities of the shell. In addition to basic command line 
processing, the shell has functions that facilitate: 


® Input/Output redirection, including filters 
@ Memory allocation 

@® Multitasking (concurrent execution) 

@ Procedure file execution 

® Built-in commands 


You can use these advanced capabilities in a virtually un- 
limited combination of ways. Of course, it’s impossible to 
give more than a representative set of examples here — but 
you’re encouraged to study the basic rules, use your imagina- 
tion, and explore the possibilities on your own. 


3.1 More About Command Line Processing 


The shell is a program that reads and processes command 
lines, one at a time, from its input path (usually your 
keyboard). Each line is first scanned (or ‘‘parsed’’) in order 
to identify and process any of the following parts which may 
be present: 


@ A program, procedure file, or built-in command 
name (‘‘verbs’’) 

@ Parameters to be passed to the program 

@ Execution modifiers to be processed by the shell 


Only the verb (the program, procedure file, or command 
name) need be present; the other parts are optional. After the 
shell identifies the verb, it processes the modifiers. Any other 
text not yet processed is assumed to be parameters and is 
passed to the program being called. 


If the verb is a built-in shell command (see Section 3.5), the 
shell simply executes it. If it’s not built in, the shell searches 
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for the appropriate program, and, when it finds it, runs it as a 
new process. 


Then the shell deactivates itself until the program being called 
terminates, at which time the shell takes the next input. The 
cycle continues until the shell detects an end-of-file in the 
input path. Then the shell terminates its own execution. 


Here’s a sample shell command line which calls the assembler: 
asm sourcefile 1 -o 3/P #12k (ENTER 


In this example: 


asm is the verb 

sourcefile 1 -o are parameters passed to Asm 

ae td is a modifier which redirects the 
output (the listing) to the system’s 
printer 

#12K is a modifier which requests that 


the process be assigned 12K bytes 
of memory instead of its (smaller) 
default amount 


Note: The verb should always be the first entry in any 
line. 


3.2 Execution Modifiers 
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Execution modifiers tailor OS-9 commands to your specifica- 
tions. Type them in a command line after the verb, and either 
before or after any parameters you’re using. 


Execution modifiers are processed by the shell before the 
program is run. If the shell detects an error in any of the 
modifiers, the run is aborted and the error reported. 


Characters which compose modifiers are stripped from the 
part(s) of the command line passed to the program as para- 
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meters. Therefore, the characters reserved for use as modi- 
fiers (#:!< > & ) can’t be used inside parameters. 


Alternate Memory Size Modifier 


When the shell involves a command program it allocates the 
program the minimum amount of working RAM memory spe- 
cified in the program’s module header. (A module header is 
part of all executable programs and holds the program’s 
name, size, memory requirements, and other information. ) 


Sometimes it’s desirable to increase this default memory size. 
You can assign memory either in 256-byte pages by using the 
modifier #n where n is the decimal number of pages, or in 
1024-byte increments by using the modifier #nK. The two 
examples below have identical results: 


copy #8 filel file2 (ENTER 
copy #2K filel file2Z (ENTER 


Each command line specifies that memory size is to be 2048 
bytes. In the first command, 8*256=2048; in the second, 
2* 1024 = 2048. 


I/O Redirection Modifiers 


Input/Output redirection modifiers reroute a program’s stan- 
dard I/O paths to alternate files or devices. 


One of OS-9’s great advantages is that its programs use stan- 
dard I/O paths rather than individual, specific file or device 
names. It’s fairly simple to redirect the I/O to any file or 
device without altering the program itself. 


Programs which normally receive input from a terminal, or 
send output to a terminal, use one or more of these three 
standard I/O paths: 


@ Standard input path: Passes data from the terminal’s 
keyboard to the program. 


@ Standard output path: Outputs data from the program 
to the terminal’s display. 
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@ Standard error output path: Outputs routine status 
messages — prompts and errors, for instance — to 
the terminal’s display. (The name ‘‘error output 
path’’ is somewhat misleading, since many kinds of 
messages besides errors travel the path.) 


Correspondingly, OS-9 offers you three redirection modifiers: 
@ < redirects the standard input path 
@ > redirects the standard output path 
@ >> redirects the standard error output path 


When you use a redirection modifier in a command line, fol- 
low it immediately with a pathlist describing the file or device 
to or from which the I/O is to be redirected. 


For example, if you want to redirect the standard output of 
the List command to write the contents of a file called corres- 
pondence to the printer instead of to the terminal, type: 


list correspondence >/P (ENTER 


Files referenced by I/O redirection modifiers are automatical- 
ly opened, created, or closed (as appropriate) by the shell. In 
the next example, the output of the Dir command — a list of 
files in the directory MEMOS — is redirected to the file /D1/ 
savelisting: 


DIR /DO/MEMOS +/Di/savelisting 
ENTER 


Then, if the list command is used on the file /D1/savelisting, 
the redirected output from the Dir command is displayed like 
this: 


list /Di/savelisting (ENTER 
Directory of /D@/MEMOS 10:15:09 
Jackson moeller Jones 


Redirection modifiers can be used before and/or after the 
program’s parameters, but each modifier can be used only 
once in a command. After the program specified in the com- 
mand is run, the redirection modifier terminates with it; when 
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you run the program again, it will use its standard I/O paths 
unless you again specify otherwise. 


Note: When processes are created, they inherit their 
parent processes’ standard I/O paths. Therefore, when 
the shell creates processes, they inherit its standard 
paths. 


3.3 Command Separators 


A single shell input line can request execution of more than 
one program. These programs can be executed sequentially or 
concurrently. “‘Sequential execution’’ means that one pro- 
gram must complete its function and terminate before the next 
program is allowed to begin execution. ‘*‘Concurrent execu- 
tion’’ means that several programs are allowed to begin ex- 
ecution and run simultaneously. 


Sequential Execution 


Programs entered on separate command lines are executed se- 
quentially. But OS-9 lets you save time by specifying on a 
single command line several commands to be executed se- 
quentially. You simply separate each full command from the 
next with a semi-colon. 


For instance: 


copy myfile /Di/newfiles dir 3/P 
ENTER 


According to this command, the shell first executes the Copy 
command. Then it enters the ‘‘waiting’’ state until Copy ter- 
minates, at which time it executes Dir. 


If an error is returned by any program, the shell doesn’t ex- 
ecute subsequent commands on the same line, regardless of 
the state of the x (abort on error) option. Otherwise, ; and 
are identical command separators. 


Here are two more examples of commands using the semi- 
colon separator: 


a5 


copy oldfile newfiles del oldfiles 


list newfile (ENTER 


dir /DISMYFILEs 126 tener o/F 3 
del temp (ENTER 


Note: In a command line with semi-colon separators, 
even though commands are listed in a particular se- 
quence and executed in that sequence, they are in fact 
all separate and equal child processes of the shell. 


Concurrent Execution 
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The second kind of command separator is the ampersand (&) 
which specifies concurrent execution. The first program you 
specify is run as a separate, child process of the shell. But the 
shell doesn’t wait for it to finish before processing the next 
command. 


The concurrent execution separator is the way you specify 
multiprogramming (running two or more programs simul- 
taneously). With the & directing the shell to divide CPU time 
equally between the processes you name in your command 
line. 


The number of programs that can run at the same time isn’t 
fixed. It depends on the amount of free memory in the system 
versus the memory requirements of the programs to be run. 


An example of a simple command line using the & separator 
1S: 


dir 2/P8& (ENTER 


The shell begins to run Dir sending output to the printer. It 
immediately displays both the number of the new process and 
a new prompt for you, like this: 


& O07 
O33: 


You can then enter another command, which will also be 
executed while output from your command continues to go to 
the printer. That’s a real timesaver for you. You don’t spend 
unproductive time waiting for OS-9 to finish a task. 
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Pipes and Filters 


Note: If you have several processes running simul- 
taneously, and want information about them, you can 
use the procs command. 


You can, if you want, use both the concurrent and sequential 
command separators in a single command line, like this: 


dir =/P& list filel& copy filel 
file?s del teme (ENTER 


Because they’re joined by & modifiers, the Dir, List, and 
Copy programs run concurrently. But the Del program 
doesn’t run until the others are terminated because the com- 
mand line contains a semi-colon to specify sequential execu- 
tion for Del. 


The third kind of command separator is !, which is used to 
construct ‘‘pipelines’’. Pipelines consist of two or more con- 
current programs whose standard input and/or output paths 
connect to each other using ‘‘pipes’’. 


Pipes are the primary means by which data is transferred from 
process to process — they’re vital to interprocess com- 
munications. Pipes are first-in, first-out buffers, “‘holding 
areas’’ for data. 


I/O transfers using pipes are automatically buffered and syn- 
chronized. A single pipe can have several ‘‘readers’’ and 
several ‘‘writers’’. Multiple writers send, and multiple read- 
ers accept, data to/from the pipe on a first-come, first-served 
basis. An end-of-file occurs if an attempt is made to read 
from a pipe when there are no writers available to send data. 
Conversely, a write error occurs if an attempt is made to 
write to a pipe with no available readers. 


Pipelines are created by the shell when it processes an input 
line with one or more ! separators. For each !, the standard 
output of the program named to the left of the ! is redirected 
through a pipe to the standard input of the program named to 
the right of the !. Individual pipes are created for each ! in the 
command line. For example: 
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UPdate timaster file ! sort 


Write report 3/P (ENTER 


Here, the Update program has its input redirected (from its 
standard input, the keyboard) to become master_file. The 
standard output from that first command, because of the !, 
becomes the standard input for the program sort. The output 
of sort, in turn — because of another ! — becomes the stan- 
dard input for the program write_report, which has its stan- 
dard output redirected to the printer. 


All programs in a pipeline are executed concurrently. The 
pipes automatically synchronize the programs so the output of 
one never “‘gets ahead’’ of the input request of the next pro- 
gram in the pipeline. This means that data can’t flow through 
a pipeline any faster than the slowest program can process it. 


Programs which are specifically designed to process data us- 
ing a pipeline or multiple pipelines are often called ‘‘filters’’. 
The Tee command, which uses pipes to allow data to be 
simultaneously ‘‘broadcast’’ from a single input path to 
several output paths, is a useful filter. 


Some of the most useful applications of pipelines are jobs like 
character set conversion, print file formatting, data compress- 
ion/decompression. 


3.4 Command Grouping 
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Sections of shell input lines can be enclosed in parentheses. 
This permits modifiers and separators to be applied to an en- 
tire set of programs. 


The shell processes the material in the parentheses by calling 
itself recursively to execute the enclosed program list. 


For example, if you want the ‘‘table of contents’’ of the root 
directory of drive 0 and then the root directory of drive 1 to 
go directly to the printer, you can type either: 


dir /D@ >/Ps dir /Di >/P (ENTER 
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or: 
(dir /D@3i dir /D1i) 3/P (ENTER 


The results are identical. The only difference is that the print- 
er is ‘‘kept’’ continuously in the second example. In the first 
example, another user could ‘‘steal’’ the printer in between 
the Dir commands. 


You can use command grouping to cause a group of programs 
to be executed sequentially, but also concurrently with re- 
spect to the shell that initiated them. For instance: 


(del fileii del fileZi del files’ 
ENTER 


Here, the shell does the overall deleting process concurrently 
with whatever else you tell it to do, because you’re using the 
&. However, the shell deletes the three specified files 
sequentially because you’re using the semicolon within the 
parentheses. 


A useful extension of this form is to construct pipelines 
consisting of both sequential and concurrent programs. For 
instance: 


(dir CMDS3 dir SYS) ! makeupPercase 


| transmit (ENTER 


The shell first processes the output of the first Dir command 
and then the second. Then it sends all the Dir output together 
to makeuppercase; then all the output, still together, 1s 
transmitted. 


3.5 Built-in Shell Commands and Option: 


When processing input lines, the shell looks for several spe- 
cial names of commands or option switches that are built into 
the shell. 


These commands are executed without loading a program and 
creating a new process, and generally affect how the shell 
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operates. They can be used at the beginning of a command 
line, or following any program separator — ;, &, or !. 


Two or more adjacent built-in commands can be separated by 
spaces or commas. 


The built-in commands and their functions are: 


chd pathlist changes the working data directory to the 
directory specified by the pathlist. 


chx pathlist changes the working execution directory 
to the directory specified by the pathlist. 


ex modname directly executes the module named. 
This transforms the shell process so that 
it ceases to exist, and a new module be- 
gins execution in its place. 


Ww waits for any process to terminate. 


* Text allows you to make a ‘‘comment?’’. 
Whatever text you specify isn’t pro- 
cessed by the shell. 


kill proc ID aborts the process specified. 

septpr proc ID number changes the process’s priority 
number. 

causes the shell to abort on any error. 

-X causes the shell not to abort on error. 

p turns the shell prompt and messages on 
(default). 

-p inhibits the shell prompt and messages. 

t makes the shell copy all input lines to 
output. 

-t doesn’t copy input lines to output 
(default). 
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The Chd and Chx commands switch the shell’s working 
directory and, by inheritance, any subsequently created child 
process. 


The Ex command is used where the shell is needed to initiate 
execution of a program without the overhead — for instance 
time spent and memory tied up — of a suspend shell process. 
The module named is processed according to standard shell 
operation, and modifiers can be used. 


3.6 Shell Procedure Files 


The shell is a reentrant program, which means that it can be 
simultaneously executed by more than one process. Like most 
other OS-9 programs, the shell uses standard I/O paths for 
routine input and output. 


OS-9’s shell offers you a special feature, a time and effort 
saver called a ‘‘procedure file’’. A procedure file is a related 
group of commands, all of which you can execute simply by 
running the one procedure file. 


For example, the Deldir command is a procedure file that 
comes with the OS-9 system. It’s actually a sequential string 
of commands (Del, Attr, and again Del), but you execute 
them all with the single command Deldir. This technique is 
sometimes called ‘‘batch’’ or ‘“‘background’’ processing. 


‘Note: If you have occasion to enter the same command 
sequences repeatedly, you can build your own proce- 
dure files by using the Build command. 


A procedure file becomes, new input for the shell. By run- 
ning a procedure file, you’re using the shell to create a new 
shell, a ‘‘subshell’’ which accepts and carries out the com- 
mands in the procedure file. 


When you enter any command line, if the shell can’t find the 
specified program in memory or in the execution directory, it 
searches the data directory for a file with the specified name. 
If it finds the file, the shell automatically interprets it as a 
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procedure file, and creates the subshell, which executes the 
commands listed in the procedure file. 


Besides eliminating repetitive manual entry of commonly 
used command sequences, procedure files can allow the com- 
puter to execute a lengthy series of programs while it’s un- 
attended, or even while it’s running other programs. That, of 
course, frees you to do other things. 


To run a procedure file — for instance, one you’ve created 
and called mailsequence — type either: 


Shell mailseauence (CENTER 
or 
mailseaquence (CENTER 


Both do exactly the same thing: create a subshell which runs 
the commands you’ve built into your mailsequence procedure 
file. 


If you want to run a procedure file in a concurrent mode, use 
the ampersand (&) modifier. OS-9 doesn’t place any con- 
straints on the number of procedure files you can run concur- 
rently, as long as there’s memory available. 


You can even build procedure files so that they themselves 
cause sequential or concurrent execution of other procedure 
files. 


Note: If you’re using procedure files to run programs 
you don’t intend to monitor closely, it’s useful to re- 
member that you can redirect standard output and stan- 
dard error output to another file. Later you can review 
the file’s contents. Output redirection eliminates the 
sometimes-annoying output of shell messages on your 
terminal at random times. 


3.7 Error Reporting 


Many programs (including the shell) use OS-9’s standard 
error reporting function, which displays an error number on 
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the error output path. (The standard error codes are listed in 
Appendix A of this manual.) If, you want you can execute 
the Printer command. It replaces the smaller, built-in error 
display routine with a larger (and slower) routine that looks 
up descriptive error messages from a text file called /DO/SYS/ 
errmsg. Once you run the printer command, it can’t be turned 
off. Also, its effect is system-wide. 


Programs called by the shell can return an error code in the 
‘‘B’’ register (otherwise B should be cleared) on termination. 
This type of error, as well as errors detected by the shell 
itself, causes an error message to be displayed, and proces- 
sing of the command line or procedure file to be terminated, 
unless the X (don’t abort on error) built-in command has been 
executed. 


3.8 Running Compiled Intermediate Code 
Programs 


Before the shell executes a program, it checks the program 
module’s language type. If it isn’t 6809 machine language, 
the shell calls the appropriate run-time system for that 
module. 


For instance, if you have BASICO9 on your OS-9 system, 
and want to run a BASICO9 I-code module called adventure, 
you can type this command: 


BASIC@9 adventure (CENTER 
or you can accomplish the same thing by typing: 
adventure (CENTER 


Both-command lines automatically call the BASICO9 run- 
time system. 
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3.9 Editing startup for Timesharing Systems 


Ad 


Your OS-9 system has a procedure file called startup, which 
among other things, asks you for the date and time each time 
you use the system. 


If you’re setting up your Color Computer as a timesharing 
system — that is, if you’re adding a terminal to it — you 
should alter the startup file so that whoever is using the other 
terminal will have appropriate access to the system. 


Use the List command to look at the present contents of start- 
up. Remember the contents. Then use the build command to 
create a startup procedure file, exactly like the original one 
except that you add this line at the end: 


tsmon /T18& (CENTER 


(You still have to press again to signal an end-of- 
file.) The tsmon command is the system’s timesharing moni- 
tor, and opens standard I/O paths for the terminal, in addition 
to running the login sequence. 
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4/Multiprogramming And 
Memory Management 


One of the most valuable capabilities of OS-9 is multipro- 
gramming, which is sometimes called timesharing or multi- 
tasking. This lets your computer run more than one program 
at the same time. Multiprogramming can be a tremendous 
advantage in many situations. For example, you can be edit- 
ing one program while another is being printed. Or you can 
use your Color Computer to control household automation 
and be able to use it at the same time for routine work and 
entertainment. 


OS-9 uses this capability all the time for internal functions. 
The simple way for you to use it is by putting the & character 
at the end of a command line the & causes the shell to run 
your command as a ‘“‘background’’, or concurrent task (see 
Chapter 3). 


In order to allow several programs to run simultaneously and 
without interference, OS-9 performs many coordination and 
resource allocation functions. The major system resources 
OS-9 manages are: 


@ The input/output system 
@ CPU time 
@ Memory 


The input/output system is discussed in Chapter 3. This chap- 
ter is designed to give you some basic information about how 
OS-9 uses CPU time and memory to optimize system 
throughput, and to make efficient multiprogramming a 
reality. 


4.1 Processor Time Allocation and Timeslicing 


CPU time is a precious resource that must be allocated wisely 
to maximize the computer’s throughput. 


Many programs by their nature spend time waiting. For ex- 
ample an interactive program, has to wait for the user to enter 
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information from the terminal. Meanwhile, the program can’t 
accomplish anything. It can only wait. 


On most systems, programs tie up CPU time while they’re 
waiting. But multiprogramming systems like OS-9 are far 
more efficient than that. They assign CPU time to only those 
programs that can effectively use the time. 


OS-9 uses a technique called *‘timeslicing,’’ which allows all 
active processes to share CPU time. Timeslicing uses both 
hardware and software functions, and works this way: On 
OS-9, a real-time clock interrupts the Color Computer’s CPU 
60 times each second. The interruption points are called 
‘‘ticks’’, and the spaces between ticks are timeslices. 


Those timeslices — 60 every second — are allocated to the 
different processes on the system. At any tick, OS-9 can sus- 
pend execution of one program and begin execution of 
another. (The starting and stopping of programs doesn’t affect 
their execution. ) 


How frequently OS-9 gives a program timeslices depends on 


the program’s assigned priority, relative to the assigned prior- 


ity of other active processes. Process priority is expressed as 
a decimal number from 0 through 255, with 0 representing 
the highest priority and 255 the lowest. 


OS-9 automatically gives the shell program a priority of 0. 
Since child processes inherit their parents’ priorities, the 
shell’s child processes all have priorities of 0. You can, if 
you want, find a process’s priority number by using the Procs 
command. You can change the priority number by using the 
Setpr command. 


It’s not possible to compute exactly the percentage of CPU 
time assigned to any particular process, because of dynamic 
variables such as time the process spends waiting for I/O de- 
vices. But you can roughly approximate the percentage by 
dividing the process’s priority number by the sum of the 
priority numbers of all active processes: 


process’s CPU share = process priority number 


sum of priority numbers 
of all active processes. 
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Note: Timeslicing happens so quickly that it looks to a 
human observer as if all processes are being executed 
simultaneously and continuously. If, however, the com- 
puter becomes overloaded with processing work, you 
may notice a delay in response to input from the ter- 
minal. Or you may notice that a ‘‘batch’’ program is 
taking longer than usual to run. 


4.2 Process States 


The CPU time allocation system automatically assigns pro- 
grams/processes one of three “‘states’’ that describe their cur- 
rent status. Process states are also important for coordinating 
process execution. A process can be in only one state at any 
instant, although state changes may be frequent. The states 
are: 


@ Active — Applies to processes currently able to 
work — that is, not waiting for input or for anything 
else. These are the only processes assigned CPU 
time. 


@® Waiting — Applies to processes which are sus- 
pended until another process terminates. This state is 
used to coordinate execution of sequential programs. 
The shell, for example, is in the waiting state during 
the time a command program it’s initiated is running. 


@ Sleeping — Applies to processes suspended by self- 
request for a specified time interval, or until receipt 
of a ‘‘signal’’. (Signals are internal messages used to 
coordinate concurrent processes.) This is the typical 
state of programs waiting for input/output operations. 


Sleeping and waiting processes aren’t assigned CPU time un- 
til they change to the active state. 


Note: The Procs command gives information about pro- 
cess states. 
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4.3 Creation of New Processes 
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First, some terminology: when one process creates another 
process, the creator is called the ‘‘parent process’’, and the 
newly created process is called the ‘‘child process’’. The new 
child can itself become a parent by creating yet another 
process. 


If a parent process creates more than one child process, the 
children are called ‘‘siblings’’ with respect to each other. If 
the parent/child relationship of all processes in the system is 
examined, a hierarchical lineage becomes evident. In fact, 
this hierarchy is a tree structure that resembles a family tree. 
(The “‘family’’ concept makes it easy to describe rela- 
tionships between processes. So, it’s used extensively in de- 
scriptions of OS-9’s multiprogramming functions.) 


The sequence of operations required to create a new process 
and initially allocate resources to it is automatically per- 
formed by OS-9’s ‘‘fork’’ function. 


If for any reason any part of the sequence can’t be performed, 
the fork is aborted and the prospective parent is passed an 
appropriate error code. The most frequent reason for failure is 
unavailablity of required resources (especially memory), or 
inability of the system to find the specified program. 


A process can create many new processes, subject only to the 
limitation of the amount of unassigned memory available. 


When the parent issues a fork request to OS-9, it must 
specify certain information: 


@ A primary module, the name of the program to be 
executed by the new process. The program can 
already be present in memory, or OS-9 can load it 
from a disk file having the same name. 


@ Parameters, data specified by the parent to be passed 
to and used by the new process. This data is copied 
to part of the child process’s memory area. (Param- 
eters are frequently used to pass file names, in- 
itialization values, and other information.) 
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The new process also ‘‘inherits’’ copies of certain of its par- 
ent’s properties. These are: 


A user number, which is used by the file security 
system and is used to identify all processes belonging 
to a specific user. (This is not the same as the ‘‘pro- 
cess ID’’, which identifies a specific process.) This 
number is usually obtained from the system pass- 
word file when a user logs on. The system manager 
is always user 0. 


Standard input and output paths, the three paths (in- 
put, output, error) used for routine input and output. 
Most paths can be shared simultaneously by two or 
more processes. 


Current (working) directories, the data directory and 
the execution directory. 


Process priority, which determines what proportion 
of CPU time the process receives. 


As part of the fork operation, OS-9 automatically assigns: 


A process ID number, from | to 255. Each process 
has a unique ID number, useful for both the system 
and the user. Process ID numbers have no rela- 
tionship with the process priority numbers. Whether 
an ID number is low or high makes no difference. 


Memory, enough for the new process to be able to 
run. In OS-9, all processes share a single address in 
memory. A data area, used for the program’s param- 
eters, variables and stack is allocated for each pro- 
cess’s exclusive use. A second memory area may 
also be needed to load the program if it’s not resident 
in memory. 
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In summary, each new process has associated with it — from 
one source or another: 


@ A primary module 
@ Parameters 

@ A user number 

@ Standard I/O paths 
® Current directories 
@ A priority 

@ An ID number 

@ Memory 


4.4 Basic Memory Management Functions 
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Memory management is an important OS-9 function. OS-9 
automatically allocates all system memory to itself and to 
processes, and also keeps track of the logical contents of 
memory (meaning which program modules are resident in 
memory at any given time). The result is that you seldom 
have to be bothered with the actual memory addresses of 
programs or data. 


Within the address space, memory is assigned from higher 
addresses downward for program modules, and from lower 
addresses upward for data area, as shown below: 


highest address 


program modules 
(RAM or ROM) 


unused space 


(RAM or empty) 


data areas 
(RAM) 
lowest address 
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9000000000000 000008000000008000080080888 


Loading Program Modules into Memory 


When performing a fork operation, OS-9 first attempts to lo- 
cate the requested program module by searching the ‘‘module 
directory’’, which has the address of every module present in 
memory. The 6809 instruction set supports a type of program 
called ‘‘reentrant code’’, which means that the exact ‘‘copy”’ 
of a program can be shared by two or more different proces- 
ses simultaneously without affecting each other, provided that 
each ‘“‘incarnation’’ of the program has an independent mem- 
ory area for its own variables. 


Almost all OS-9 family software is reentrant, and can make 
the most efficient use of memory. For instance, BASICO9 
requires 22K bytes of memory in order to be loaded. Suppose 
that OS-9 receives a request (from a process) to run 
BASICO09, but has already caused it to be loaded into memory 
at the request of another process. OS-9 doesn’t have to cause 
another copy to be loaded, using another 22K of memory. 
Instead both processes share the same copy of BASICO9. 


OS-9 automatically keeps track of how many processes are 
using each program module and deletes the module when all 
processes using the module have terminated. This frees the 
modules memory for other uses. 


If the requested program module isn’t already in memory, 
OS-9 uses its name as a pathlist (filename) and attempts to 
load the program from disk. 


Every program module has a ‘‘module header’’ describing the 
program and its memory requirements. OS-9 uses the header 
to determine how much memory for variable storage should 
be allocated to the process. The module header also includes 
other important descriptive information about the program, 
and is an essential part of OS-9 operation at the machine lan- 
guage level. (For detailed description of memory modules 
and module headers, check the OS-9 Technical Information 
manual.) 


Programs can also be explicitly loaded into memory using the 
Load command. As with ‘‘fork’’, the program is actually 
loaded only if it isn’t already in memory. 
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If the module isn’t in memory, OS-9 copies the requested 
module from the file into memory, verifies the CRC. If the 
module isn’t already in the module directory, OS-9 adds it to 
the directory. This process is repeated until all the modules in 
the file are loaded, the 64K memory limit is exceeded, or 
until a module with an invalid format is encountered. OS-9 
always links to the first module read from the file. 


If the program module is already in memory, the load process 
still begins in the same way: OS-9 loads the module from the 
file and verifies the CRC. But then when it attempts to add 
the module to the module directory, and notices that the mod- 
ule is already known there, it merely increments the known 
module’s link count — the number of processes using the 
module. 


You can use Load to “‘lock’’ a program into memory. That’s 
a timesaver if you need to use the same program repeatedly. 
With Load the program is kept continuously in memory. OS- 
9 doesn’t have to take the time to load it each time you use it. 


The opposite of Load is the Unlink command, which de- 
creases a program module’s link count by one. When this 
count becomes zero, indicating that the module is no longer 
used by any process, the module is deleted. Its memory is 
deallocated and its name is removed from the module direc- 
tory. The Unlink command is generally used in conjunction 
with the Load command. (Programs loaded by ‘‘fork’’ are 
automatically unlinked when the program terminates). 


Suppose, for instance, you’re planning to use the Copy com- 
mand 10 times in a row. Normally the Copy program is 
loaded each time you enter the Copy command. But if you 
lock the Copy module into memory, and then enter your 
string of commands, you won’t have to wait while Copy is 
loaded and unloaded repeatedly. You'll finish your work 
more quickly. When you’re done, use Unlink to unlock the 
module from memory. The sequence looks like this: 
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load copy (ENTER 

cory failel fileta 
copy file? fileza 
copy file3 file3a 
copy filed fileda (ENTER 
copy fileS fileSa (ENTER 
copy fileG fileGa 
copy file? file7a 
cory file8 fileSa 
copy file9S fileSa 
copy filel@ filei@a (ENTER 
unlink cory (CENTER 


It’s important to use Unlink after the program is no longer 
needed; otherwise the program continues to occupy memory 
which could be used for other purposes. 


Note: Be very careful not to unlink modules in use by 
any process, or you'll cause the memory used by the 
module to be deallocated, and its contents destroyed. 
The result is a user’s nightmare: all programs using the 
unlinked module crash. 


Loading Multiple Program: 


Another important aspect of program loading is the ability to 
have two or more programs resident in memory at the same 
time. This is possible because all OS-9 program modules are 
written as ‘‘position-independent code’’, or **PIC’’. PIC 
programs don’t have to be loaded into specific, predetermined 
memory addresses to work correctly. They can therefore be 
loaded at different memory addresses at different times. 


PIC programs require special types of machine language in- 
structions which few computers have. The ability of the 6809 
microprocessor to use this type of program is one of its most 
powerful features, and one of the greatest aids toward multi- 
programming. 


Since more than one program can reside in memory, you can 
therefore use the Load command two or more times (or have 
a single file contain several memory modules), and each 
program module is automatically loaded at different, non- 
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overlapping addresses. (Most other operating systems write 
over the previous program’s memory whenever a new pro- 
gram is loaded). 


This technique also means that you don’t have to be directly 
concerned with absolute memory addresses. 


Note: Any number of program modules can be loaded 
until available system memory is full. 


Memory Fragmentation 
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Even though PIC programs can be loaded initially at any 
address where free memory is available, program modules 
can’t be relocated dynamically afterwards. That means that 
once a program is loaded, it must remain at the address at 
which it was originally loaded. 
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This characteristic can lead to a sometimes troublesome phe- 
nomenon called *‘memory fragmentation’’. When a program 
is loaded, it’s assigned the first sufficiently large block of 
memory at the highest address possible in the address space. 
If several program modules are loaded, and subsequently one 
or more modules located in between other modules is un- 
linked there’ll be several fragments of free memory space. 
The sum of the sizes of the free memory spaces may be quite 
large. But because they’re scattered, there won’t be enough 
free space in a single block to load a program module larger 
than the largest free space. 


The Mfree command shows the location and size of each un- 
used memory area, and the Mdir e command shows the 
address, size, and link (use) count of each module in the 
address space. You can use both commands to detect frag- 
mentation. And you can usually ‘‘defragment’’ memory by 
unlinking scattered modules and reloading them. (Make cer- 
tain none of the modules is in use before doing so.) 
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5/Use Of The System Disk 


OS-9 systems use a system disk to load many parts of the 
operating system during system startup, and to provide files 
frequently used during normal system operations. Therefore, 
the system disk is generally kept in disk drive zero (/DQ) 
when the system is running. 


Two files used during the system startup operation, OS9Boot 
and startup are provided and must remain in the system disk’s 
root directory. Other files on the system disk are organized 
into three directories: CMDS (commands), DEFS (system- 
wide definitions), and SYS (other system files). Still other 
files and directories created by the system manager and/or 
users can also reside on the system disk. (These frequently 
include each user’s initial data directory.) 


5.1 The OS9BOOT File 


The file called OS9Boot is loaded into RAM memory by the 
‘‘bootstrap’’ routine located in the OS-9 firmware. It includes 
file managers, device drivers and descriptors, and any other 
modules which are permanently resident in memory. The OS- 
9 System Master Disks OS9Boot file contains these modules: 


TOMan OS-9 input/output manager 
RBE Random block (disk) file manager 
SCF Sequential character (terminal) 
file manager 
PipeMan Pipeline file manager 
Piper Pipeline driver 
Pipe Pipeline device descriptor 
CCIO Keyboard/video graphics device driver 
PRINTER Printer device driver 
RS232 RS-232 serial port device driver 
CCDisk Disk driver 
DO, D1, D2, D3 Disk device descriptor 
TERM Terminal device descriptor 
P Printer device descriptor 
Tl RS-232 serial port device descriptor 
P Printer (parallel) device descriptor 
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Pl Printer (serial) device descriptor 
Clock Real-time clock module 
SYSGO System startup process 


You can create new bootstrap files, which can include addi- 
tional modules, by using the OS9Gen command. Any module 
loaded as part of the bootstrap can’t be unlinked, and is 
stored in memory with a minimum of fragmentation. You 
may find it advantageous to include in the OS9Boot file any 
module you use constantly during normal system operation. 


3.2 The SYS Directory 


The directory /DO/SYS contains two important files: 


® password (the system password file — see the Login 
command) 
@ errmsq (the error message file — see 3.7) 


These files, and the SYS directory itself, aren’t absolutely 
required to boot OS-9, but they’re needed if you plan to use 
Login, Tsmon, or Printerr. You can add other system-wide 
files of a similar nature, if you want to. 


3.3 The startup File 
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The title /DO/startup is a shell procedure file which is auto- 
matically processed immediately after system startup. You 
can include in startup any legal shell command line. Many 
people choose to include Setime to start the system clock. If 
this file isn’t present, the system will still start correctly but 
you have to run Setime manually. 
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5.4 The CMDS Directory 


The directory /DO/CMDS is the system-wide command object 
code directory, normally shared by all users as their working 
execution directory. The vital shell program is part of CMDS. 
The system startup process ‘‘sysgo’’ makes CMDS the initial 
execution directory. 


5.5 The DEFS Directory 


The directory /DO/DEFS contains assembly language source 
code files. They in turn contain common system-wide sym- 
bolic definitions normally included in assembly language pro- 
grams by means of the OS-9 assembler “‘use’’ directive. The 
presence and use of this directory is optional, but highly rec- 
ommended for any system used for assembly language pro- 
grams. The files commonly contained in this directory are: 


® OS9Defs — Main system-wide definition file 
@ RBFDefs — RBF file manager definition file 
@ SCFDefs — SCF file manager definition file 
@ SysType — System types definition file 


5.6 Changing System Disks 


Most OS-9 users prefer to leave the system disk in place 
while the system is running, particularly with multiuser sys- 
tems. Leaving it in place guarantees that it won’t be taken 
away just when someone is using it. 


If you do remove the disk and begin to use another one, let 
OS-9 know where you want to be on the new disk by using 
the Chd and Chx commands. (For directions, see Chapters 2 
and 6.) Those commands set both working directory pointers 
— data and execution — for the new disk. 
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In general, it’s unwise to remove a disk and insert another 
while any files are open. And it’s just plain dangerous to your 
data to make a disk exchange if any files on the first disk are 
open in the “‘write’’ or ‘‘update’’ modes. 


5.7 Making New System Disks 


To make a system disk, it’s necessary to do these four things: 
1. Format the new disk 


2. Create and link the OS9Boot file by using the 
OS9Gen or Cobbler command 


3. Create or copy the startup file 


4. Copy the CMDS and SYS directories, and the files 
they contain 


You can perform steps 2 through 4 manually, or do them 
automatically by using any one of these methods: 


@ Create and use a shell procedure file 


@ Use a shell procedure file generated by the Dsave 
command 


@ Use the Backup command 
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6/System Command Descriptions 


This chapter contains alphabetical descriptions of each of the 
command programs supplied with OS-9. The commands are 
ordinarily called using the shell, but can also be called from 
most other programs in the OS-9 family, including BASICO9, 
Interactive Debugger, Macro Text Editor, and others. Unless 
otherwise noted, the programs described in this section are 
designed to run as individual processes. 


6.1 Organization of Entries 


Each command entry is organized to include: 
@ The name of the command 


@ A ‘‘syntax’’ line, which shows you what format, or 
‘*syntax’’ to use when you type the command 


@ A brief definition of what the command does 
@ Further details about the command and how to use it 


@ Information about any options available with the 
command 


® One or more examples of command usage 


6.2 Command Syntax Notations 


It’s important to enter the various parts of a command in the 
correct order, and in the correct format. The syntax line in 
each command description helps you do that by showing you 
exactly what each command requires. 


The syntax line always begins with the name of the com- 
mand. Occasionally, that’s all you'll need (except, of course, 
for pressing (ENTER)). But other commands either require, or 
will accept, parameters — variables which give instructions 
to OS-9. And many commands offer you built-in options. 
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The syntax line gives you that information by using these 
notations: 


Italics — Italics indicates a variable for you to supply, for 
instance the name of a file (filename), a directory (direc- 
tory name), or a complete path to a file or directory (path- 
name). Some other variables are: devices (devname), 
memory modules (modname), process ID numbers (pro- 
cID), options (options), a list of parameters (paramlist), 
and text (text). (In a command situation, text means a 
character string terminated by an end-of-line.) Another 
variable you will encounter is arglist, or argument list. 
Similar to paramlist, but is generally broader in scope, 
including modifiers, program specifications and so forth. 


[ | — Brackets indicate that the material within them is 
optional to the command. 


.. — An ellipsis indicates that the material immediately pre- 
ceding can be repeated within the command. For instance, 
[filename]|...] means that you can, specify more than one 
filename to the command. 


The command syntax doesn’t include the shell’s built-in op- 
tions (for instance I/O redirection), because the shell filters 
out its options before the command line is passed to the pro- 
gram being called. 


6.3 System Commands 
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This section describes the format and use of OS-9 commands. 


The following list is a summary of these commands: 


Attr Change file attributes 

Backup Make disk backup 

Binex Convert binary to s-record 

Build Build text file 

Chd Change working data directory 

Chx Change working execution directory 
Cmp File comparison utility 

Cobbler Make bootstrap file 
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Copy 
Date 
Dcheck 
Del 
Deldir 
Dir 
Display 
Dsave 
Dump 
Echo 
Exbin 
Format 
Free 
Ident 
Kall 
Link 
List 
Load 
Login 
Makdir 
Mdir 
Merge 
Mfree 


OS9Gen 


Printerr 
Procs 
Pwd 
Pxd 
Rename 
Save 
Setime 
Setpr 
Sleep 
Shell 
Fee 
Tmode 
Tsmon 
Unlink 
Verify 
Xmode 


Copy data 

Display system date and time 
Check disk file structure 
Delete a file 


Delete all files in a directory system 


Display file names in a directory 
Display converted characters 


Generate procedure file to copy files 


Formatted file dump 

Echo text to output path 

Convert s-record to binary 
Initialize disk media 

Display free space on device 
Print OS-9 module identification 
Abort a process 

Link module into memory 

List contents of disk file 

Load module(s) into memory 
Timesharing system log-in 
Create directory file 

Display module directory 

Copy and combine files 

Display free system RAM memory 
Build and link a bootstrap file 
Print full-text error messages 
Display processes 

Print working directory 

Print execution directory 

Change file name 

Save memory module(s) on a file 
Activate and set system clock 
Set process priority 

Suspend process for period of time 
OS-9 command interpreter 


Copy standard input to multiple output paths 


Change terminal operating mode 
Timesharing monitor 
Unlink memory module 


Verify or update module header and CRC 


Examine or change device initialization mode 
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ATTR 


ATTR filename | permission abbreviations | 
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Examines or changes the security permissions of a file. 


To enter the command, type Attr followed by the name of the 
file whose security permissions are to be changed. Then type 
a list of permissions which are to be turned on or off. A 
permission is turned on by giving its abbreviation, or turned 
off by preceding its abbreviation with a minus sign. Permis- 
sions not explicitly named are not affected. If no permissions 
are given, the current file attributes will be printed. 


You can’t change the attributes of a file you don’t own. User 
zero, can change the attributes of any file in the system. 


File permission abbreviations are: 


d Directory 

S Shareable file 

r Read permit to owner 

WwW Write permit to owner 

e Execute permit to owner 
pr Read permit to public 
pw Write permit to public 
pe Execute permit to public 


You can use the Attr command to change a directory to a file 
if all entries have been deleted from it. You can’t change a 
file to a directory with this command (see Makdir). 


Examples: 
attr myfile -pr -pw (ENTER 

removes read and write permissions from the public. 
attromyfile rw oe pr pw pe (ENTER 


gives the file’s owner, and the public, read, write and execute 
permissions. 
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BACKUP 


BACKUP 


attr datalog (ENTER 


-~§-Wr-i Tt 


Since the command doesn’t specify permissions, Attr displays 
the current permissions of the Datalog file. 


[e] [s] [-v] [devname| |devname| 


Physically copies all data from one device to another. 


A physical copy is performed, sector by sector, without re- 
gard to file structures. In almost all cases, the devices speci- 
fied must have exactly, the same format (size, density, and so 
forth) and must not have defective sectors. 


If you omit both device names, the names /DO and /D1 are 
assumed. If you omit only the second device name, a single- 
unit backup will be performed on the drive specified. 


Options are: 


S Exits if any read error occurs 
S Prints single-drive prompt message 
-V Does not verify 


#nK Allow more memory (n= amount of memory), 
and therefore speed up the backup procedure 


Examples: 
backure /D2 /D3 (ENTER 


makes a backup of the diskette in Drive 2 on to the diskette in 
Drive 3. 


backup -v (ENTER 


assumes the names DO and D1, and makes the appropriate 
backup without verification. 
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bacKue (CENTER 


Ready to BACKUP from /D®@ to 
/D1i Tt: Y (ENTER 
MYDISK 
is being scratched 
uk. 7S -¥ 
Number of sectors copied: $@276 
Verify Pass 
Number of sectors verified: $0276 


This example shows a complete interchange between the 
Backup command and the user who entered it. In the example 
/D1, the destination disk, is named MYDISK. ‘‘Scratched’’ 
means ‘‘erased’’. 

The following is an example of a single-drive backup. Back- 
up reads a portion of the source disk into memory and then 
prompts you to remove the source disk and put the destination 
disk into the drive. Then Backup writes on the destination 
disk. Then you remove the destination disk and put the source 
disk back into the drive. This continues until Backup copies 
the entire disk. Giving Backup as much memory as possible 
will necessitate fewer disk exchanges. 


backup /DO #32K (ENTER 


Ready to BACKUP from /D@ to 
ue oe 
Ready DESTINATION,s hit a Key: 
MYO LK 

is being scratched 
an ee ¥ 
Ready SOURCE,+ hit a Key: 
Ready DESTINATION, hit a Keys 
Ready SOURCE>+ hit a Ker: 
Ready DESTINATION, hit a Keys 


(several repetitions) 


Ready DESTINATION:,s hit a Key: 
Number of sectors copied: #$@276 
Werify Pass 

Number of sectors verified: #@276 
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BINEX 
EXBIN 


BINEX filename! filename2 
EXBIN filenamel filename2 


Binex converts a binary file into an S-Record file, and Exbin 
converts an S-Record file into a binary file. 


An S-Record file is a type of text file that contains records 
representing binary data in hexadecimal character form. This 
Motorola-standard format is often directly accepted by com- 
mercial PROM programmers, emulators, logic analyzers and 
similar devices that are RS-232-interfaced. It can also be use- 
ful for transmitting files over data links that can handle only 
character-type data; or to convert OS-9 assembler- or com- 
piler-generated programs to load on non-OS-9 systems. 


Binex converts filename], an OS-9 binary format file, to a 
new file named filename2 in S-Record format. If you invoke 
Binex on a non-binary load module file, OS-9 prints a warn- 
ing message and asks you if Binex should proceed anyway. A 
‘‘Y’” response means yes; any other answer will terminate the 
program. S-Records have a header record to store the pro- 
gram name for informational purposes, and each data record 
has an absolute memory address which is not meaningful to 
OS-9 since it uses position-independent code. However, the 
S-Record format requires them, so Binex will prompt the user 
for a program name and starting load address. For example: 


binex /D@/CMDS/scanner scanner,.5Sl 


ENTER 

Enter starting address for file: 
$120 

Enter name for header record: 
scanner 


To download the program to a device such as a PROM pro- 
grammer (for example, using serial port /T1), type: 


list scanner.Si1 2/T1 (ENTER 


65 


BUILD 


BUILD filename 


66 


Exbin is the inverse operation; filenamel is assumed to be an 
S-Record format text file which Exbin converts to pure binary 
form on a new file called filename2. The load addresses of 
each data record must describe continguous data in ascending 
order. 


Exbin doesn’t generate or check for the proper OS-9 module 
headers or CRC check value required to actually load the 
binary headers or CRC check value required to actually load 
the binary file. You can use the Ident or Verify commands to 
check the validity of the modules if they’re to be loaded or 
run. 


Example: 


exbin Program.S1 CMDS/program 
ENTER 


Builds short text files by copying the standard input path into 
the file specified by filename. Build creates a file according 
to the filename parameter, then displays a **?’’ prompt to 
request an input line. Each line entered is written to the out- 
put path (the file). Entering a line consisting of only a car- 
riage return terminates Build. 


Examples: 
build smalloefile (ENTER 


creates a new file called small — file and puts into it whatever 
you type at the keyboard. 


build /P (ENTER 
directs whatever you type to the printer. 


build <mytext /T1 (CENTER 
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Using Build, you can also transfer, or redirect, material from 
one file to another. Instead of the keyboard, the standard in- 
put path is the first file you name in the command. The out- 
put path is the second. In this example, the mytext file 
becomes the input path, and is copied to Terminal 1, the out- 
put path. 


build newfile (CENTER 


THE POWERS OF THE 05-9 
OPERATING SYSTEM ARE TRULY (ENTER 
FANTASTIC. (CENTER 

ENTER 


sa} ca} ca) +2] 


list newfile (ENTER 


THE POWERS OF THE O5-9 
OPERATING SYSTEM ARE TRULY 
FANTASTIC, 


This example shows an interchange between Build and the 
user. After building newfile, the user employs the List com- 
mand to check the contents of the newly built file. 


CHD 
CHX 


CHD pathname or directory name 
CHX pathname or directory name 


Chd changes the current data directory, and Chx changes the 
current execution directory. 


Many commands in OS-9 work with user data such as text 
files, programs and so forth. These commands assume that 
a file is located in the working data directory. Other OS-9 
commands assume that a file is in the working execution 
directory. 
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CMP 


The Chd and Chx commands don’t appear in the CMDS 
directory, because they’re built in to the shell. 


Examples: 
chd /D1/PROGRAMS (ENTER 


change the current data directory the PROGRAMS data direc- 
tory located on the diskette in drive 1. This example shows 
the use of a pathname. 


chx «+ (CENTER 


moves the user to the directory immediately above the current 
execution directory. 


chx binary efiles/text Programs 
ENTER 


is another example of the use of a pathname to change 
another execution directory. 


chx /D@/CMDSs chd /D1 (ENTER 


changes both the execution and data directories. 


CMP filenamel!: filename2 
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Opens two files and performs a comparison of the binary 
values of the corresponding data bytes of the files. 


If any differences are encountered, the file offset (address) 
and the values of the bytes from each file are displayed in 
hexadecimal. 


The comparison ends when an end-of-file marker is encoun- 
tered on either file. Cmp then displays a summary of the 
number of bytes compared and the number of differences 
found. 
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COBBLER 


Examples: 
cmp red blue (ENTER 
Differences 


byte #1 # > 


QBSAOB13 02 O1 
QAAWAASS B@ Bi 
QABABABSA a, AB 
QAAAAASB 3B 3b 
OGABAAIBEC 6D 6S 


Bytes compared: PGAAAAASD 
Bytes differents: GAAAAAAS 


cmp red red (ENTER 
Differences 


None «+. 


Bytes compared: AAAAAALSD 
Bytes different: AAAAAAAY 


COBBLER devname 


Creates the OS-9BOOT file required on any disk from which 
OS-9 is to be bootstrapped. 


The boot file consists of the same modules which were loaded 
into memory during the most recent bootstrap. (To add mod- 
ules to the bootstrap file use the OS9Gen command.) Cobbler 
also writes the OS-9 kernel on the first fifteen sectors of track 
34, and excludes these sectors from the diskette allocation 
map. If any files are present on these sectors, Cobbler will 
display an error message. 


The boot file must fit into one contiguous block on the disk- 
ette. For this reason, Cobbler is normally used on a freshly 
formatted diskette. If Cobbler is used on a diskette without a 
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COPY 


contiguous block of storage large enough to hold the boot 
file, the old boot file may be destroyed, and OS-9 won’t be 
able to boot from that diskette until it’s reformatted. 


Example: 
cobbler /D@ (ENTER 


WARNING - FILE(S) OR KERNEL 
PRESENT ON TRACK 34 - THIS 
TRACK NOT REWRITTEN 


Saves current device attributes on the current system disk. 


Note: This command is often used after Xmode to per- 
manently change device attributes. 


COPY pathname pathname [-s| 
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Copies data from the first file or device specified to the 
second. 


The first file or device must already exist. The second file is 
automatically created if the second pathname is a file on a 
diskette. Data can be of any type and is not modified in any 
way as it’s copied. 


Copy transfers data using large block reads and writes until it 
reaches an end-of-file marker on the input path. Because 
block transfers are used, normal output processing of data 
doesn’t occur on character-oriented devices such as terminals 
and printers. Therefore it’s better to use List Copy when a 
file consisting of text is to be sent to a terminal or printer. 
With Copy, important codes (e.g. line feed) won’t be added. 


The -s option causes Copy to perform a single-drive copy 
operation. The second pathname must be a full one if you use 
-Ss. In a single-drive procedure, Copy reads a portion of the 
source disk into memory. Then you remove the source disk 
and put the destination disk into the drive, and enter a ‘‘C’’ 


@©@@eeeoeeeeeeeoeeeeeeeeeeeeeeeeeee ee 8 OF 


5@@eeooeoeeeeeeeeeeeeeeeeeeeeeeee eee eee @ 


DATE 


DATE [t] 


then Copy writes on the destination disk, with the process 
continuing until the entire file is copied. 


Using the shells alternate memory size modifier to give a 
large memory space increases speed and reduces the number 
of media exchanges required for single-drive copies. 


Examples: 
copy filel file2 #153 (ENTER 
copies filel to file2 giving 15K of memory. 


copy /D1i/JOE/news /D@/PETER 
messages (ENTER 


copies the news file on the diskette in Drive 1 to the mes- 
sages file on the diskette in Drive 0. 


copy /TERM /P (ENTER 


sends — copies — to the printer of anything you type into the 
console. 


copy /D@/cat /D@/animals/cat 
-s #32K (ENTER 

Ready DESTINATION: hit C to 
continues: c 

Ready SOURCE; hit C to continue: c 

Ready DESTINATION: hit C to 
continue: c 


This is an example of the alternating method used in a single- 
drive copy operation. 


Displays the current date, and, if you use the t option, the 
current system time. 
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DCHECK 


Examples: 
date *% 

displays the system date and time 
date t 2/P (ENTER 

directs the command’s output to the printer. 
setime 


YESHNSOG HAs AMe Ss 
TIME? &8L/@4/15 14.79.09 


date (ENTER 
Arpril 15, 1981 


date +t (ENTER 
April 15, 1981 14,290.20 


This sequence illustrates setting a new date and time for the 
system by using the Setime command, and then using Date 
and it’s t option to check system date and time. 


DCHECK |[-opts| devname 
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Checks disk file structure. 


It’s possible for sectors on a diskette to be marked as being 
allocated, but in fact not to be actually associated with a file 
or the diskette’s free space. This can happen if a diskette is 
removed from a drive while files are still open, or if a direc- 
tory which still contains files is deleted. Dcheck is a diagnos- 
tic you can use to detect this condition, as well as to check 
the general integrity of the directory/file linkages. 


Dcheck is given the drive number of the diskette to be 
checked as a parameter. After verifying and printing some 
vital file structure parameters, Dcheck follows pointers down 
the diskette’s file system tree to all directories and files on the 


@o@e@e@e@ee2e020080020020eeeeeeeeeeeee eee ee @ @ 


»5@e@eedeeeeeeeeeeeeeeeeeeeeeeeeeeeee Gt 


ae 


diskette. As it does so, it verifies the integrity of the file 
descriptor sectors, reports any discrepancies in the directory/ 
file linkages, and builds a sector allocation map from the seg- 
ment list associated with each file. If any file descriptor sec- 
tors (FDS) describes a segment with a cluster not within the 
file structure of the diskette, Dcheck reports a message like 
this: 


«**x Bad FD segment ($xxxxxx-$yyyyyy) for file: 
(pathname) 


This indicates that a segment starting at sector xxxxxx and 
ending at sector yyyyyy can’t really be on this diskette. 
There’s a good chance the entire FD is bad if any of its seg- 
ment descriptors is bad. The allocation map is not updated for 
corrupt FDs. 


While building the allocation map, Dcheck also makes sure 
that each diskette cluster appears once and only once in the 
file structure. If it discovers duplication, Dcheck displays a 
message like: 


Cluster $xxxxxx was previously allocated 


This message indicates that Dcheck has found cluster xxxxxx 
at least once before in the file structure. The message may be 
printed more than once if a cluster appears in a segment in 
more than one file. 


Then Dcheck compares the newly created allocation map with 
the allocation map stored on the diskette, and reports any 
differences in messages like: 


Cluster $xxxxxx in allocation map but not in file 
structure 

Cluster $xxxxxx in file structure but not in allocation 
map 


The first message indicates that sector number xxxxxx (hexa- 
decimal) was found not to be part of the file system, but was 
marked as allocated in the diskette’s allocation map. In addi- 
tion to the causes mentioned in the first paragraph, some sec- 
tors may have been excluded from the allocation map by the 
Format program because they were defective. Or they may be 
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the last few sectors of the diskette, the sum of which was too 
small to compose a cluster. 


The second message indicates that the cluster starting at sec-. 


tor xxxxxx 1s part of the file structure but is not marked as 
allocated in the diskette’s allocation map. It’s possible that 
this cluster may be allocated to another file later, overwriting 
the contents of the cluster with data from the newly allocated 
file. (Any clusters that have been reported as ‘‘previously 
allocated’’ by Dcheck, as described above, surely have this 
problem.) 


Dcheck options include: 


-§ Displays count of files and directories 
only 

-b Suppresses listing of unused clusters 

-p Prints pathnames for questionable 
clusters 

-w=pathname Specifies path to directory for work 
files 

-m Saves allocation map work files 

-O Prints Dcheck’s valid options 


The -s option causes Dcheck to display a count of files and 
directories only. Only FDs are checked for validity. The -b 
option suppresses listing of clusters allocated but not in file 
structure. The -p option causes Dcheck to make a second pass 
through the file structure, printing the pathlists for any clus- 
ters that Dcheck finds as ‘‘already allocated’’ or ‘‘in file 
structure but not in allocation map’’. The -w option tells 
Dcheck where to locate its allocation map work file(s). The 
pathname specified must be a full pathname for a directory. 
(The directory /DO is used if -w is not specified.) It is recom- 
mended that this pathlist not be located on the diskette being 
Dchecked if the diskette’s file structure integrity is in doubt. 


Dcheck builds its diskette allocation map in a file called path- 
name/Dcheckpp0O, where pathname is as specified by the -w 
option, and pp is the process number in hexadecimal. Each 
bit in this bitmap file corresponds to a cluster of sectors on 
the diskette. If the -p option appears on the command line, 
Dcheck creates a second bitmap file (<pathname2>/ 
Dcheckpp1) that has a bit set for each cluster Dcheck finds as 
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'5@@ee00020000000000000000000080080000006 


‘‘previously allocated’’ or ‘‘in file structure but not in alloca- 
tion map’’. Dcheck then makes another pass through the 
directory structure to determine the pathnames for these ques- 
tionable clusters. You can save the bitmap work files by 
specifying the -m option on the command line. 


For best results, Dcheck should have exclusive access to the 
diskette being checked. Otherwise Dcheck may be fooled if 
the diskette allocation map changes while it’s building its bit- 
map file from the changing file structure. Dcheck can’t pro- 
cess diskettes with a directory depth greater than 39 levels. 


Examples: 
deheck /D2 (ENTER 


Volume - ‘My system disk’ on 
device /D2 

$#0209AQ bytes in allocation map 

1 sector Per cluster 

$020@0276 total sectors on media 

Sector $0@@00@002 15 start of root 
qi Peotory FU 

$0010 sectors used for ids 
allocation mar and root 
directory 

Building allocation maP work 
filers. 

Checking allocation map files... 


‘My system disk’ file structure is 


intact 

1 directory 

=~ files 

deheck -mpw=/D2 /D? 

Volume - ‘System disk’ on device 
/D@ 


$€00GdG bytes in allocation map 

1 sector Per cluster 

$€02AGLZA total sectors on media 

Sector $0@@0002 15 start of root 
directory FD 


fe 
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$201@ sectors used for ids 
allocation marP and root 
directory | 

Building allocation map work 
TL lias 

Cluster #00040 was previously 
allocated 

*¥** Bad FD segment ($111111- 
$23AGFQ) for file: /D@/TEXT/ 
Junky.file 

Checking allocation maP files... 

Cluster #800038 in file structure 
but not in allocation map 

Cluster $#080003B in file structure 
but not in allocation map 

Cluster #@@01B9 in allocation map 
but not in file structure 

Cluster #@8@@01BB in allocation map 
but not in file structure 


Pathlists for auestionable 
clusters: 

Cluster #800038 in Path: 
/d@/OS9boot 

Cluster $080003B in path: 
/d@/OS9boot 

Cluster #200040 in Path: 
/d@/OS9boot 

Cluster #200040 in Path: 
f/d@/test/double.file 


1 Previously allocated cluster 

found 

clusters in file structure but 

not in allocation map 

© clusters in allocation maP but 
not in file structure 

1 bad file descriptor sector 


fJ 


‘System disk’ file structure is 
rot intact 

S directories 

fo 172.185 


Pr 
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DEL 


DEL |[-x] filename [...] 


Deletes the file(s) specified. 


You must have write permission for the file(s). Directories 
cannot be deleted unless they’re changed to files or you use 
the Deldir command. (See the Attr command description.) 


If you use the -x option, Del assumes the current execution 
directory. 


Examples: 


del texturProgram oldetestuprogram 
ENTER 


deletes the two files specified. 


del /Di/number five (ENTER 


uses a complete pathname to specify the file named number — 
five on the diskette in Drive 1. 


del -x cmds.subdir/file (CENTER 


specifies a file called cmds.subdir/file in the current execution 
directory. 


dir /D1i (ENTER 


GLTOCtETY BT (DL tases 
my file newfile 


del newfile (ENTER 
dir /Di (ENTER 


directory of /D1 14.3¢0,:.37 
myfile 


In this interchange, the user first employs the Dir command 
to see what files are in the /D1 directory. Command output 
indicates that /D1 has two files: myfile and newfile. The user 


ay 


DELDIR 


employs the Del command to delete newfile, and then uses 
Dir again to make certain that newfile has been deleted. 


DELDIR directory name 
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Deletes all files in a directory and the directory itself. 


This command is a convenient alternative to manually delet- 
ing directories and the files they contain. Use it only when 
you want to delete everything in a directory, including the 
directory itself, other directories and all the subdirectories and 
files in them. 


When Deldir runs, it prints a prompt message after the com- 
mand line: 


deldir OLDFILES (ENTER 

Deleting directory file. 

List directory, delete directory » 
orguit ? (1l/d/49) 


An | response causes a Dir e command to run so you can see 
the files in the directory before they’re deleted. 


A d response initiates the deletion process. 
A q response aborts the command before action is taken. 


The directory to be deleted may include other directories 
which may themselves include other directories, and so forth. 
In this case, Deldir operates recursively (that is, it calls itself) 
so all lower-level directories are automatically deleted. The 
lower-level directories are processed first. 


You must have correct access permission to delete all files 
and directories encountered. If not, Deldir will abort when 
it encounters the first file for which you don’t have write 
permission. 
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The Deldir command automatically calls the Dir and Attr 
commands, so they must reside in the current execution 
directory. 


DIR 


DIR [e] [x] [directoryname or pathname] 
Displays a formatted list of file names in a directory. 


If no parameters are given, the current data directory is 
shown. If the x option is given, the current execution direc- 
tory is shown. If a full pathname of a directory is given, it 1s 
shown. Results are displayed on the standard output path. 


If the e option is included, each file’s entire description is 
displayed: size, address, owner, permissions, date and time 
of last modification. 


Examples: 
dir 

displays the current data directory. 
dir x 

displays the current execution directory. 
dir x e 


displays the entire description of all files in the current execu- 
tion directory. 


dir .»«+ (ENTER 


displays the parent of the current working directory — the 
directory immediately above it in the hierarchy. 


dir newstuff (ENTER 


displays the newstuff directory 
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DISPLAY 


dir e TEXT PROGRAMS (ENTER 


displays the entire description of all files in the directory 
called TEST _ PROGRAMS. 


DISPLAY <hex> |...| 


DSAVE 


Reads one or more hexadecimal numbers given as param- 
eters, converts them to ASCII characters, and writes them to 
the standard output. 


Display is commonly used to send special characters (such as 
cursor and screen control codes) to terminals and other I/O 
devices. 


Examples: 
disPlay @C >P (ENTER 
reroutes ‘‘form feed’’ — hex OC — to the printer. 


display 41 42 43 44 45 46 (ENTER 
ABCDEF 


is an example of a command and the resulting output; 
ABCDEF are ASCII characters corresponding to hex 41 42 
43 44 45 46. 


DSAVE [-opts| [devname| |directoryname or pathname | 
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Backs-up or copies all files in one or more directories. 


Dsave is unlike most other commands in that it does not 
directly affect the system. Instead, it generates a procedure 
file which you execute later to actually do the work. 
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When you run Dsave, it writes copy commands to standard 
output to copy files from the current data directory on dev- 
name (the default is /DO) to the directory specified by direc- 
toryname or pathname. If you don’t specify a directory name 
or pathname the copy is performed to the data directory that 
is the current directory at the time the Dsave procedure file is 
executed. 


If Dsave encounters a directory file, it automatically includes 
Makdir and Chd commands in the output before generating 
copy commands for files in the subdirectory. Since Dsave is 
recursive in operation, the procedure file exactly replicates all 
levels of the file system from the current data directory down- 
ward (such a section of the file system is called a ‘‘subtree’’). 


If the current working directory happens to be the root direc- 
tory of the disk, Dsave creates a procedure file that backs up 
the entire disk file by file. This is useful when it’s necessary 
to copy many files from diskettes formatted differently, or 
from floppy diskettes. 


Dsave options are: 


-b — Make output diskette a system 
diskette by using source disk- 
ette’s OS9Boot file, if present 

-b = pathname | — Make output diskette a system 
diskette using pathname as 
source for the OS9Boot file 


-1 — Indent for directory levels 
-| — Do not process directories be- 
low the current level 
-m — Do not include Makdir com- 
mands in procedure file 
-sinteger — Set copy parameter to integer K 
Examples: 


chd /D2 (ENTER 

dsave /D2 3/D@/makecory (CENTER 
end #D4 

/D@/makecory (ENTER 


The first command positions the user in /D2, the directory to 
be copied. Then Dsave makes a procedure file — actually a 
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DUMP 


directory — makecopy. The Chd command specifies that the 
copy is to be made on the the /D1 directory, and the final 
command executes the procedure file. 


DUMP [filename or devname | 
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Produces a formatted display of the physical data contents of 
the path specified, which may be a diskette or any other I/O 
device. 


If you don’t specify a filename, Dump uses the standard input 
path — the keyboard. Dump writes output to the standard 
output path — the video display. This command is commonly 
used to examine the contents of non-text files. 


Dump displays data 16 bytes to a line in both hexadecimal 
and ASCII character format. Data bytes that have non- 
displayable values are represented by periods in the character 
area. 


The addresses displayed on the dump are relative to the be- 
ginning of the file. Because memory modules are position- 
independent and stored on files exactly as they exist in 
memory, the addresses shown on the dump correspond to the 
relative load addresses of memory-module files. 


Examples: 
dime (CENTER 


displays keyboard input in hex. Output is written to the video 
display. 


dump @/D1 


The ‘@’ symbol causes OS-9 to treat the entire disk as a file. 


@2@0e0e000008008e8eeeeeeeeeeeeeeeeeeee ee @ 


UEREEREREEREREREERERERERERERERERERERER ERD DO YOO 


ECHO 


ECHO text 


Sample Output: 


dump SYS/password 


Addr 


BAAS 
2B 
2819 
2018 
2d2O0 
QOB28 
BB38 
0838 


Addr 


2BAB 
2048 
GBSO 
0038 
28690 
2868 
2278 


The first column indicates the starting address. The next eight 
columns (01 through EF) display data bytes in hexadecimal 
format. The final column (0 through E) displays data byes in 
ASCII’ format. Non-ASCII displayable bytes are shown as 


Se Fee ee 


ZucGu@eosiseauudl 
2Fd443@2F 43404453 
2CZEZCS34B8454C4C 
GUS seeder es l2oee 
sizCei gece Cee st 
ZE2CS348454C4C8D 
wa ee pa | ba on Bae # a DOG De 9 
2C31 gedbeuceZu2e 


2CS348454C4CO0D55 
Sud veedueo else 
GI Genoeoee eee inl 
SS4B454C4C0D5553 
MoS 23edZ20Gde2032 
seveebe2ezGZe2los 
48454C4Cap 


99+Oe120% 
/D@/CMDS 
i 7SReLL 
sUSER 1.4 4 
bo l26 +64 
+ »>SHELL + 
USERS #42 


91268 +6 96 


*SHELL.U 
SERGs+3+ 
128 +4964 
SHELL« US 
ERG++4,1 
2B +444 95 
HELL « 


periods, in the ASCII character display section. 


Echoes entered text to the standard output path 


Echo is typically used to generate messages in shell procedure 
files or to send an initialization character sequence to a ter- 
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minal. The text shouldn’t include any of the punctuation char- 
acters used by the shell. 


Examples: 
echo HELLO+ HOW’S IT GOING? 


prints the messge on the screen. This example would be use- 
ful as a background task. 


echo +P LISTING OF PASSWORD FILE: 
list SYS/password ?/PR8. 
& 283 


eaf 


prints the message — listing of password file — to the printer 
and lists the file SYS/password to the printer as a background 
task. 


LISTING OF PASSWORD FILE 
#*90+128+/D8/CMDS;. +SHELL 
WOEWL» #1412094 94 SHELL 
UWSER2 69291204444 4 SHELL 
USGN34 39126 #6 oo SHELL 
USER4G:++4+128+.%9. +SHELL 


Here is the example run. 


echo =/TERM **WARNING#* DISK ABOUT 
TO BE SCRATCHED! (ENTER 


echoes the text to the console. 


echo =:/P LISTING OF TRANSACTION 
FILEs List Trans ?/P8 (ENTER 


combines two commands. The first echoes the entered text to 
the printer. The second (List) directs the contents of the trans 
file to the printer. 
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FORMAT 


FORMAT devname 


Physically initializes, verifies, and establishes an initial file 
structure on a diskette. All diskettes must be formatted before 
you can use them on an OS-9 system. 


The diskette to be formatted must NOT be write protected. If 
the write-protect foil tab is in place, no error codes will be 
generated. The system will return to the OS-9: prompt. The 
diskette will not be formatted. 


The formatting process works this way: 


1. Format physically initializes and sectors the diskette 
surface. 


2. Format reads back and verifies each sector. If a sector 
fails to verify after several attempts, it’s excluded from the 
initial free space on the diskette. As the verification pro- 
ceeds, track numbers are displayed on the standard output 
device. 


3. The diskette allocation map, root directory, and identifica- 
tion sector are written to the first few sectors of track 
zero. These sectors must not be defective. 


Format will prompt for a diskette volume name, which can be 
up to 32 characters long and can include spaces or punctua- 
tion. (Later, you can use the Free command to display the 
name.) 


For step-by-step instructions on formatting, refer to Getting 
Started with OS-9. 
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FREE 


FREE |devname | 
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Displays the number of unused 256-byte sectors on a device. 
These sectors are available for new files or for expanding 
existing files. 


The device name you specify must be a disk drive. Free also 
displays the diskette’s name, creation date, and cluster size. 
If you don’t specify a device, drive 0 is assumed. 


Data sectors are allocated in groups called ‘‘clusters’’. The 
number of sectors per cluster depends on the storage capacity 
and physical characteristics of the specific device. This means 
that small amounts of free space are divisible into fewer files. 
For example, if a given disk system uses 8 sectors per clus- 
ter, and a Free command shows 32 sectors free, a maximum 
of four new files could be created, even if each has only one 
cluster. 


Examples: 


free (ENTER) 

COLOR COMPUTER DISK created ons: 
Ho7 Oo7 2a 

Capacity: 630 sectors (l-~sector 
clusters) 

13 Free sectors: largest block 
12 sectors 


free /Di 

DATA DISK created on: 83/06/16 

CaPacity: G30 sectors (1-sector 
clusters) 

443 Free sectors; largest block 
442 sectors 
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IDENT 


IDENT filename |-opts| 


Displays header information from OS-9 memory modules. 


Ident displays the module size, CRC bytes (with verification), 
and, for program and device driver modules, the execution 
offset and the permanent storage requirement bytes. Ident 
prints and interprets the type/language and attribute.revision 
bytes. Ident displays the byte immediately following the mod- 
ule name because most Microware-supplied modules set this 
byte to indicate the module edition. 


Ident displays 


Options are: 


all modules contained in a diskette file. 


-m Assumes that filename is a module in memory 

-V Does not verify module CRC 

-X 6Assumes that filename is in execution 
directory 

-S Displays on a single line module information 
including edition byte (first byte after module 
name); type/language byte; module CRC; **.”’ 
if CRC verifies, ‘‘?’’ if it doesn’t, a blank 
space if you use the ‘‘-v’’ option; and module 
name. 

Examples: 

ident -m ident (ENTER 

Header for: Ident 

Module size: $2G6CE #1742 

Module CRC: $G114F4 (Good) 

Hdr Parity: SEQ 

Exec. off: $0235 #5635 

Data size: $099C #2460 

Edition: $26 #6 
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Ty/La At/Ry $11 #81 
Prog mod» 6809 obJj+ re-en 


In the example, Hdr parity = header parity; Exec. off = 
execution offset; Data size = permanent storage require- 
ments; Edition = first byte after module name; Ty/La/ At/Rv 
= type/language attribute/revision; and Prog mod, 6809 obj, 
re-en = module type, language, attribute. 


ident /D@/OS9boot -s (ENTER 
2 $61 $524CEB « ECBisk 

S82 $Fil $EDF@4G . DO 

S2 $Fl #699330 . Dil 

S2 $€Fi 653603 . b2 

ge $Fl #6155808 « BS 

$E1l #@AGA@A . CCIO 
$Fil $3EDF55 . TERM 
$Cl $BD@579 . I0Man 
$#Dil $#C@GCBG . RBF 

$D1l #@d4D9EG . SCF 

$#Cl $1795D0@ . SysGo 

Ol B7/25000 «~ Clack 

#11 $99ECC8 « Shel 
$t1 $315E37 «4 RSZ32 

$P1 #7BF6CE « Ti 

$E1 #31GE57 . PRINTER 

$Fi $8@8@DF . P 

$D1 $$5F72A5 . PirpeMan 

$E1l $5B2B5G6 . Piper 

$F1 #CC@GAF . Pire 


oO 


a8) 


0 PJ 
SMOG OM SH UNS mM BW 


0 


Since the -s option appears in the command line, Ident dis- 
plays each module’s information on a single line. In the first 
line of the output, for instance, 1 = edition byte (first byte 
after name); $CO = type/language byte; $A366DC = CRC 
value; . = OK CRC check; and OS9p2 = module name. 
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KILL 


KILL procID 


Aborts the process specified by its process ID number. 


The process to be aborted must have the same user ID as the 
user executing the command. (Use the Procs command to 
obtain the process ID numbers.) 


If a process is waiting for I/O, it may not die until it com- 
pletes the current I/O operation. Therefore, if you Kill a 
process and the Procs command shows it still exists, it’s 
probably waiting to receive a line of data from a terminal 
before it can die. 


Since this is a built-in shell command, it doesn’t appear in the 
CMDS directory. 


Examples: 
Kill 3 (CENTER 


kills the process with the ID number 5 


Procs (ENTER 


User # ID pty __state Mem Primary module 
@ Z "4 active Z Shell 
2 1 "4 waiting 1 Sysgo 
@ 3 0 sleeping 2@ Copy 


kill 3 (ENTER 
Procs (ENTER 


User # ID ety state Mem Primary module 
0 2 0 active < Shell 
@ 1 "4 wWalting 1 S¥ysgo 


In this example, the user employs the Procs command to de- 
termine the ID number of the process to be killed, and finds 
that the number is 3. The Kill command kills the process. 
Then the user again employs Procs, this time to check 
whether the targeted process has died. Since it doesn’t appear 
in the output, the user knows the process has been killed. 
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LINK 


LINK memory module name 


LIST 


LIST filename |... | 
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‘‘Locks’’ a previously loaded module into memory. 


The link count of the module specified is incremented by one 
each time it is “‘linked’’. Use the Unlink command to ‘‘un- 
lock’’ the module when you no longer need it. You must use 
the Load command prior to using Link. Modules that are not 
Linked in memory will not be included in the ‘‘Cobbler’’ 
OS9Boot file, if you use the Cobbler command. 


Examples: 
link edit (ENTER 


locks the edit module into memory. 


Lists the contents of a text file. 


This command copies text lines from the filename to the stan- 
dard output path. The program terminates upon reaching the 
end-of-file of the last input path. If more than one filename is 
specified, the first file will be copied to standard output, the 
second file will be copied next, and so forth. 


This command is most commonly used to examine or print 
text files. 


Examples: 
list /D@/startup -/P & (CENTER 


Lists the contents of the Startup file, with output directed to 
the printer. The ampersand tells OS-9 to give the printing job 
a low priority. 


ePPRRARRERERERRERERARRERREREERERARRERERERR EES , 


9000000000000 00000000680000888CCC8 


t 
ad 


LOAD 


LOAD pathname 


list /DIi/USERS/document /D@/myfile 
/D@/BOB/ text (CENTER 


Lists the contents of three files. 
list /TERM ?/P (ENTER 


Copies what you type at the keyboard to the printer. To go 
back to the standard output path — the video display — press 
CLEAR) and (BREAK) simultaneously. 


build animals 
? Cat 

* cow (CENTER 

dog 
elephant 
bird 

fish 

ENTER 


list animals 
Cat 

CO lal 

dog 

elephant 

bird 

fish 


ME a eh ef eh 


Here the user employs Build to create a file called animals, 
and enters six items into it. The List command, with the file- 
name animals as a parameter, displays the contents of the 
new file. 


Loads modules from file into memory. 


The path specified is opened and one or more modules is read 
from it and loaded into memory. The names of the modules 
are added to the module directory. If a module is loaded that 
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has the same name and type as a module already in memory, 
the module with the highest revision level is kept. 


Example: 
mdir (ENTER 


Module Directory at 13:36:47 


use OS9r2 INIT 
Boot CCDisk Dg 

Di D2 3 

rte be TERM TOMan 
RBF Sor SysGo 
CLoenk Shell Roe 
4 PRINTER P 
PireMan Piper Pire 
Mdair 


load edit (ENTER 
modir (CENTER 


Module Directory at 13:37:14 


OSs) OS59r2 INIT 
Boot CCDisk D@ 

D1 D2 Oo 
Clip TERM TOMan 
RBF iar SysGo 
Clock Shell Recor 
13 PRINTER a 
PireMan Piper Pire 
Mdir Pad, 


First, the Mdir command displays the names of modules cur- 
rently resident in memory. Then the Load command loads the 
Edit module into memory. Mdir again lists memory modules, 
this time showing that Load has successfully been added to 
memory. 


TER EREURERERESESEURC ERE RESP ERERERERERERY, 
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LOGIN 


LOGIN 


Provides login security on timesharing systems. 


Login is automatically called by the timesharing monitor 
Tsmon, and can also be used after initial log-in to change a 
terminal’s user. 


Login requests a user name and password, which it checks 
against a validation file. If the information is correct, the us- 
er’s system priority, user ID, and working directories are set 
up according to information stored in the file, and the initial 
program — usually shell — specified in the password file is 
executed. If the user can’t-supply a correct user name and 
password after three attempts, the process is aborted. 


The validation file is /DO/SYS/password. The file contains 
one or more variable-length text records, one for each user 
name. Each record has the following fields, delimited by 
commas: 


1. User name (up to 32 characters; may include 
spaces). If this field is empty, any name will match. 


2. Password (up to 32 characters; may include spaces). 
If this field is omitted, no password is required by 
the user whose record this is. 


3. User index (ID) number (from 0 to 65535; O is su- 
peruser). This number is used by the file security 
system, and as the system-wide user ID, to identify 
all processes initiated by the user. The system man- 
ager should assign a unique ID to each potential 
user. 


4. Initial process (CPU time) priority: 1-255. 


5. Pathlist of initial execution directory (usually /DO/ 
CMDS). 


6. Pathlist of initial data directory (the specific user’s 
directory). 
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7. Name of initial program to execute (usually Shell). 
Don’t use shell command lines, such as Dir or 
Dcheck, as initial program names. 


Here’s a sample validation file: 
,0,128,/D0/CMDS,., SHELL 
USER, ,1,123..,,;SHELL 
USER,,2,128,.,., SHELL 
USER ,.3,128,.5, SHELL 
USER, 4,128 ,.4;, SHELL 


To use the Login command, enter: 
login (ENTER 


This will cause prompts for the user’s name and (optionally) 
password to be displayed. If they’re answered correctly, the 
user is logged into the system. Login initializes the user num- 
ber, working execution directory, and working data directory, 
and executes the initial program specified by the Password 
file. It also displays the date, time and process number 
(which is not the same as the user ID). 


If the shell from which Login was called will not be needed 
again, you can discard it by using the Ex command to start 
the Login command. For example: 


ex login (CENTER 


To edit Password and add users to the system, use the OS-9 
text editor. 


Logging Off the system 


To log off the system, terminates the initial program specified 
in the password file. For most programs (including shell) this 
involves typing an end-of-file character as the first character 
on a line. and (BREAK), pressed simultaneously, signal 
end-of-file and log you off. 


Displaying a ‘‘Message-of-the-Day”’ 


A file named Motd, in the SYS directory, will cause Login to 
display its contents on the user’s terminal after successful 
login. (This file isn’t necessary for Login to operate.) 


e@eeeoeoeeoeoceoeoenoooeooeaooeao eo oeoeoeaeoeeooeo oe eeeee eee € 


peegeq@e@e@eeeeeeeeeeeeeeeeoeedeoeeeee ee e866 & 


Example: 
login (ENTER 


OS-9 Level 1 Timesharing System Verison 1.2 83/12/04 
15202322 


User name?t: superuser (CENTER 


Password: secret (ENTER 


Process #07 logged 83/12/04 
13:03:20 
Welcome! 


To edit Motd, use the OS-9 Text Editor. 


MAKDIR 


MAKDIR pathname or directory name 


Creates a new directory according to the pathname given. The 
pathname must refer to a parent directory for which the user 
has write permission. 


The new directory is initialized and at first does not contain 
files except for the ‘*.”’ and ‘*..’’ pointers to its parent direc- 
tory and itself, respectively. All access permissions are en- 
abled (except sharable). 


It’s customary, but not mandatory, to capitalize directory 
names. 


Examples: 
makdir /DiI/STEVE/PROJECT (ENTER) 
creates a directory by using its full pathname from the root. 
makdir DATAFILES 


creates a directory called DATAFILES within the current 
working directory. 
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makdir .«+/SAVEFILES (ENTER 


creates a directory called /SAVEFILES in the parent 
directory. 


MDIR 


MDIR [e] 
Displays the present module names in the system module 
directory, that is all modules currently resident in memory. 
If you use the e option, you’ll see a full listing of the physical 
address, size, type, revision level, reentrant attribute, user 
count, and name of each module. All numbers shown are in 
hexadecimal. 
Examples: 
mdir (ENTER 

Module Directory at 14:44:35 

osg OSdp2 ee 

Boot Cotati a Sh Dd 

Di D2 D3 

CE1o TERM LOMan 

RBEF ar SO Sysgo 

Cicek Shell RS232 

be | PRINTER P 

PireMan Piper Pire 

Mdir 
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MERGE 


mdir e (ENTER 


Module Directory at 10:55:04 


ADDR SIZE TY RY AT UC NAME_ 
Es0S ZF FL 1 D@ 

FO59 7ES Ci ir os9 

Fes2 4F4 Ci ir OSgP2 
FD4G6 2E CO 1 r INIT 
C363 798 El -i r 2 CCIO 
CAFB 38 Fi ir 2 TERM 


This is a partial listing of all the attributes of the modules in 
memory after executing the above command. 


Warning: Many of the modules by Mdir are OS-9 system 
modules and executable as programs. Always check the mod- 
ule type code before running a module if you aren’t familiar 
with it! 


MERGE [filename] [...| 


Copies multiple input files specified by the parameter(s) to 
the standard output path. 


Merge is commonly used to combine several files into a sin- 
gle output file. Data is copied in the order the filenames are 
given. Merge does no output line editing (such as automatic 
line feed). The standard output is generally redirected to a file 
or device. 


Merge can be used to append or copy any type or mixture, of 
files to another device. 


Examples: 


merge filel file? file3 filed 
*combined.file (CENTER 
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MFREE 


MFREE 


OSIGEN 


OS9Gen devname 
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merges the four files specified into a new file called com- 
bined.file and sends the results directly to the new file, in- 
stead of to the video display. 


merge comPile,list asm-list :/P 
ENTER 


merges the two files specified and sends the output to the 
printer. 


Displays a list of memory areas not presently in use and 
therefore available for assignment. 


Displays the address and size of each free memory block. The 
size 1S given as the number of 256-byte pages. This informa- 
tion is useful to detect and correct memory fragmentation. 


Example: 


mf ree (ENTER 


Address Pages 
E@Q-BiFF iGd 
Badaa@-Bd4FF i 
Total Pages free = 165 


Graphics Memory Not Allocated 


Creates and links the OS9Boot file required on any disk from 
which OS-9 is to be bootstrapped. 


BAABRARAREZRERARARERERERRERERERARRERRE ERE RESR SE RZ, 


1@e@eeoe@20008080080000000000000000006000000008 


OS9Gen is used to add modules to an existing boot, or to 
create an entirely new boot file. (If you want an exact copy of 
the existing OS9Boot file, use the Cobbler command in- 
stead). 


The name of the device on which the OS9Boot file is to be 
installed is passed to OS9Gen as a command line parameter. 
OS9Gen then creates a working file called tempboot on the 
device specified. Next it reads file names (pathnames) from 
its standard input, one pathname per line. Every file named is 
opened and copied to tempboot. This is repeated until an end- 
of-file marker or a blank line is reached on OS9Gen’s stan- 
dard input. All boot files must contain the OS-9 component 
modules listed in section 5.1. 


After all input files are copied to tempboot, the old OS9Boot 
file, if present, is deleted. Tempboot is then renamed 
OS9Boot, and its starting address and size are linked in the 
disk’s Identification Sector (LSN 0) for use by the OS-9 boot- 
strap firmware. 


Note: Any OS9Boot file must be stored in physically 
contiguous sectors. Therefore, OS9Gen is normally 
used on a freshly formatted disk. If the OS9Boot file is 
fragmented, OS9Gen prints a warning message indicat- 
ing that the disk can’t be used to bootstrap OS-9. 


The list of file names given to OS9Gen can be entered from a 
keyboard, or OS9Gen’s standard input can be redirected to a 
text file containing a list of file names. If you enter names 
manually, no prompts are given, and you enter the end-of-file 
marker (usually or a blank line) after the line 
containing the last filename. 


Examples: 


To manually install a boot file on device /D1 which is an 
exact copy of the OS9Boot file on device /DO. 


O59Gern /Di (ENTER 
/D@/OS9Boot (ENTER 
CLEAR) (BREAK 
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PRINTERR 


PRINTERR 
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The first command line runs OS9Gen. The second enters the 
name of the file to be installed, and the third enters an end- 
of-file marker. 


To manually install a boot file on device /D1 which is a copy 
of the OS9Boot file on device /DO with the addition of mod- 
ules stored in the files /DO/tape.driver and /D2/video. driver: 


OS9Gen /Dl 
/D@/OSS9Boot 
/DO@/tape.,driver 
/D2/video.,driver (ENTER 
CLEAR) (BREAK 


The first command line runs OS9Gen. The second enters the 
main boot file name. The third and fourth enter the names of 
the two files to be added, and the fifth enters and end-of-file 
marker. 


To do exactly what the previous example does, but to do it 
automatically by redirecting the standard input for OS9Gen; 


build /D@/bootlist 

* #DO/OSSBo0o0t 

? /D@/tape-.driver 

? /D2/video.driver 

* (ENTER 

OS9Gen /Di </D@/bootlist 


The first command line uses Build to create a file called 
Bootlist. The next three lines enter the names of the three 
files within Bootlist. The fifth line terminates Build, and the 
sixth and final line runs OS9Gen with input redirected from 
the new Bootlist file. 


Prints full-text error messages. 


This command replaces OS-9 error printing routine (F$Perr), 
which prints only error code numbers, with a routine that 


POSCOOCHOSCOCHOCOOOCOOSCOCOCOHOESOSCOCOSCOOOCCOCES 
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PROCS 


PROCS [e]| 


reads and displays textual error messages from the file /DO/ 
SYS/errmsg. Printerr’s effect is system-wide. 


A standard error message file is supplied with OS-9. The user 
or editor can replace or modify this file, which is a normal 
text file with variable-length lines. 


Each error message line begins with the error number code 
(in ASCII characters), a delimiter, and the error message text. 
The error messages need not be in any particular order. De- 
limiters are spaces or any character numerically lower than 
$20. Any line with delimiter as its first character is con- 
sidered to be a continuation of the previous line(s); this per- 
mits multi-line error messages. 


Warning: Once the Printerr command has been used, it can 
not be undone. Once installed, DO NOT unlink the Printerr 
module. Printerr uses the current user’s stack for an I/O buf- 
fer, so users are encouraged to reserve reasonably large 
stacks. The only way to effectively Unlink Printerr is to re- 
boot or reset the machine using OS-9. 


Example: 
erinterr (ENTER 


Note: The errmsg file must be on /DO. 


Displays a list of processes running on the system. 


Normally lists only processes having the user’s ID. If the e 
option is given, Procs lists processes of all users. The display 
is a ‘‘snapshot’’ taken at the instant the command is executed: 
processes can switch states rapidly, usually many times per 
second. 


Procs shows the user and process ID numbers, priority, state 
(process status), memory size (in 256 byte pages), primary 
program module, and standard input path. 
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Example: 


Procs e (ENTER 


User # Id pty state | Mem Primary module 
"y Z @ active < Shell 
"4 1 Q@ waiting 1 SysGo 
1 3 1 waiting Sd Tsmon 
1 4 1 waiting 4 Shell 
1 > 1 active 64 BASIC@9 


PWD 
PXD 


PWD 
PXD 


Pwd shows the path from the root directory to the current 
data directory. Pxd shows the path to the current execution 
directory. 


OS-9 programs use both commands to track the actual physi- 
cal location of files. People use it when they get “‘lost’’ in the 
file system. Both commands, show a path ‘‘home’’. 


Examples: 


ehd /DI/STEVE/TEXATFILES/MANUALS 
ENTER 


using a full pathname, Chd changes the user’s current data 
directory, so the user is now in the MANUALS directory. 


Pivid (CENTER 
/DI/STEVE/TEXTFILES/MANUALS 


Pwd shows the full path to the working directory. 


chd ..+ (ENTER 
Pitd (CENTER 
JULSSTEVEZTEATEILES 
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The user ‘‘backs up’’ one level in the directory hierarchy, and 
then asks what the working directory is. Pwd shows that it is 
now TEXTFILES. 


chd «4. ENTER 
Pitd (ENTER 
/DI/STEVE 


The user again backs up, and sees, with Pwd, that the work- 
ing directory is now STEVE. 


exd (ENTER 
/D@/CMDS 


The user sees that the current execution directory is CMDS. 


RENAME 


RENAME filename new filename 


Gives the file or directory specified in the pathlist a new 
name. 


The user must have write permission for the file in order to 
change its name. It’s not possible to change the names of 
devices, NE ee 
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Examples: 
rename blue Purple 
gives the new name purple to the file formerly called blue. 
rename /D3/user9/test teme 
gives the new name temp to the file formerly called /test. 
dir 


Ni Pfectary of »« JBr2e2250 
myfile animals 


rename animals cars (ENTER 


dir (ENTER 
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DL PEEEOTY Of 2 1B r2ae2ze 
myfile cars 


In this sequence, the user employs Dir to see the name of 
files in the current data directory. Then Renames changes 
name of file called animals to the new name cars. Another 
Dir command shows that the name has been changed. 


SAVE 


SAVE filename modname |... | 


Creates a new file and writes a copy of the memory mod- 
ule(s) specified onto the file. 


The module name(s) must exist in the module directory when 
saved. Save gives the new file access permissions for all 
modes except public write. 


Note: Save’s default directory is the current data direc- 
tory. Executable modules should generally be saved in 
the default execution directory. 


Examples: 
save D@/CMDS/workcount weoount 


saves the wcount module into the newly created file called 
/workcount in the /DO/CMDS. 


save /Dl/mathurpack add sub mul div 


saves four modules (add, sub, mul and div) into the new file 
called /D1/math — pack 


SETIME 


SETIME [yy/mm/dd/hh:mm:ss | 


Sets the system date and time, then activates the real time 
clock. 
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The date and time can be entered as parameters. If no param- 
eters are given, Setime will issue a prompt. Numbers are one- 
or two-decimal digits using space, colon, semicolon or slash 
delimiters. OS-9 system time uses the 24-hour clock, on 
which, for instance, 1520 is 3:20 P.M. 


Important Note: This command must be executed be- 
fore OS-9 can perform multitasking operations. 


Examples: 
setime 83+12+15+1545 (ENTER 
sets the date and time to December 15, 1983, 3:45 P.M. 


setime 83/12/15 15/45/00 (ENTER 


sets the same date in a slightly different, but equally accept- 
able format. 


SETPR 


SETPR procID number 
Changes the CPU priority of a process. 


The process priority number is a decimal number in the range 


0 — the lowest — to 255. If you need information about 
the process ID number and current priority, use the Procs 
command. 


You can use Setpr only on processes which have your ID 
number on them. 


Note: This command does not appear in the Cmds 
directory because it is built into the shell. 


Examples: 
setpr 8 25@ (ENTER 
sets or changes process #8 to priority 250 


Procs (ENTER 


105 


SHELL 


SHELL arglist 
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m Primary module 


I e 

Q 3 @ waiting 2 Shell <TERM 
2 @ waiting 1 Shell <TERM 
1 @ waiting 1 Sysgo <TERM 


setpr 3 128 (ENTER 
Procs (ENTER 


User # ID pty state | Mem Primary module 
@ a 128 active 2 Shell <TERM 
Q 2 @ waiting 2 Shell <TERM 
2 1 @ waiting 1 Sysgo <TERM 


The Procs command displays process ID numbers and other 
information. The next command — Setpr 3 128 — sets pro- 
cess #3 to a priority of 128. The final command checks to 
make sure the change has been made. 


The shell is OS-9’s command interpreter program. It reads 
data from its standard input path (the keyboard or a file), and 
interprets the data as a sequence of commands. The basic 
function of the shell is to initiate and control execution of 
other OS-9 programs. 


The shell reads and interprets one text line at a time from the 
standard input path. After interpretation of each line, it reads 
another until it reaches an end-of-file marker at which time 
it terminates itself. A special case occurs when the shell is 
called from another program. In that case, it takes the ar- 
gument list as its first line of input. If this command line 
consists of *‘built-in’’ commands only, the shell reads and 
processes more lines. Otherwise control returns to the calling 
program after the single command line is processed. 


The rest of this description is a technical specification of the 
shell syntax. Use of the shell is described fully earlier in this 
manual. 
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Shell Input Line Formal Syntax: 


<pgm line> : 


= <pgm> {<pgm>} 


<pgm> := [<params>] [<name> [<modif>] 
[pgm params>] [<modif>] 


{<sep>} 


Program Specifications: 


<name> := 


<module name> 
<pathname> 


= ( <pgm list> ) 


Parameters: 


<params—> := 
<deliim> := 
<param> := 


<param> { <delim> <param> } 
space or comma characters 
ex <name> [<modif>] chain to program 


chd <pathlist> 

kill <procID> 
setpr<procID> <pty> 
chx <pathname> 


WwW 


ee ex 


specified 

change working 
directory 

send abort signal to 
process 

change process 
priority 

change execution 
directory 

wait for any process 
to die 

turn OS9: prompting 
on 

turn prompting off 
echo input lines to 
std output 

don’t echo input 
lines 

don’t abort on error 
abort on error 
comment line: not 
processed 
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<sep> : sequential execution 

separator 

concurrent execu- 

tion separator 

= | pipeline separator 

Se 2) end-of-line (se- 
quential execution 
separator) 


| 
& 


Modifiers: 


<modif> := <mod> { <delim> <mod> } 


<mod> := < <pathname> redirect standard 
input 
> <pathname> redirect standard 
output 
:= >> <pathname> redirect standard 
error output 
# <integer> set process memory 
size in pages 
:= # <integer> K set program memory 
size in 1K 
increments 


SLEEP 


SLEEP tick count 


Puts the process to ‘“‘sleep’’ for a number of clock ticks. 


Tick count may be any number | through 65535. If any num- 
ber larger than 65535 is given for tick count, the number will 
be reduced by mod 65535. For example, 65536 would be 
reduced to 0; as would all multiples of 65536. A tick count of 
95000 would be reduced to an actual tick count of 29464. 


Sleep is generally used to generate time delays or to ‘‘break- 
up’’ CPU-intensive jobs. The duration of a tick is 16.66 
milliseconds. 
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TEE 


A tick count of 1 causes the process to ‘‘give up’’ its current 
time slice. A tick count of zero causes the process to sleep 
indefinitely (the process is usually awakened by a signal). 


Example: 
sleep 25 (ENTER 


puts the process ‘‘to sleep’’ for 25 ticks...416.50 
milliseconds. 


list startup SYS/motd nothing & 
sleep @ 

8.004 

setime </TERM 


WELCOME TO COLOR COMPUTER O5-92 


-~004 
ERROR #216 


OSos 


The, List command starts running as a child process invoked 
from shell, and is run as background task. The Sleep 
command then puts shell to sleep indefinitely. When List 
eventually encounters the file nothing, which doesn’t exist, it 
terminates, and sends a signal (the error status), which wakes 
up shell. 


It’s important to note, that if the error hadn't occurred, shell 
would have slept forever. (The keyboard is not read while the 
shell sleeps.) The only way out, would be to re-boot. 


TEE pathname or devname |...| 


Copies standard input to multiple outputs. 


Tee is a filter that copies all text lines from its standard input 
path and also to any number of additional output paths whose 
names are given as parameters. 
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TMODE 


The example below uses a pipeline and Tee to send the out- 
put listing of the Dir command simultaneously to the 
terminal, the printer, and a disk file: 


Examples: 
dir e ! tee /?P /D@/dir.listing 


Here, a pipeline takes the output of the Dir e command and 
sends it to the terminal and Tee. Tee in turn sends the output 
along to the printer and to a file called /DO/dir. listing. 


asm pgdm.esre 1 ! tee Poms-list /P 
ENTER 


In this example, the pipeline and Tee send the output of an 
assembler listing to a file (pgm.list) and to the printer. 


ECHO WARNING SYSTEM DOWN IN 
i@ MINUTES ! tee /2T1 (ENTER 


Here, a message is broadcast to the terminal. 


TMODE |[.pathnum| |paramiist] |... | 
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Displays or changes the operating parameters of the user’s 
terminal. 


You can specify any number of parameters from the list be- 
low, separating them by spaces or commas. If you don’t 
specify parameters, the output will be current Tmode status. 


You can also use a period and a number to specify the path- 
number to be affected. If you don’t specify any, Tmode 
affects the standard input path. 
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Note: If this command is used in a shell procedure file, 
you must use the parameter. .pathnum to specify one of 
the standard output paths (0, 1, or 2) to change the 
terminal’s operating characteristics. The change will re- 
main in effect until the path is closed. To effect a 
permanent change to a device characteristic, the device 
descriptor must be changed. 


This command can work only if a path to the file/device has 
already been opened. You may alter the device descriptor to 
set a device’s initial operating parameter (see the OS-9 Tech- 
nical Information manual). 


upc 


-upc 


bsb 


-bsb 


bsl 


-bsl 


echo 


-echo 


Upper-case only. Lower-case characters are 
automatically converted to upper-case. 


Upper-case and lower case characters 
permitted. 


Erase on backspace: backspace characters 
echoed as a backspace-space-backspace se- 
quence (default). 


No erase on backspace: echoes single back- 
space only. 


Backspace over line: lines are ‘‘deleted’’ by 
sending backspace-space-backspace sequences 
to erase the same line (for video terminals) 
(default). 


No backspace over line: lines are ‘‘deleted’’ by 
printing a ‘‘new line’’ sequence (for hard-copy 
terminals). 


Input characters ‘‘echoed’’ back to terminal 
(default). 


No echo. 


Auto line feed on: line feeds automatically 
echoed to terminal on input and output carriage 
returns (default). 


Mito line feed off. 


111 


112 


pause Screen pause on: output suspended upon full screen. 


-pause Screen 


pull=7 


bell=h 


eor=h 


eof =h 


type =h 


reprint =h 


dup =h 


psc =h 


abort =h 


See pag parameter for definition of screen 
size. Resume output by typing any key. 


pause mode off. 


Set null count: number of null ($00) characters 
transmitted after carriage returns for return de- 
lay. The number is decimal. Default = 0. 


Set video display page length to n (decimal) 
lines. Used for ‘‘pause’’ mode, see above. 


Set input backspace character. Numeric value 
of character in hexadecimal. Default = 08. 


Set output backspace character. Numeric value 
of character in hexadecimal. Default = 08. 


Set input delete line character. Numeric value 
of character in hexadecimal. Default = 18. 


Set bell (alert) output character. Numeric value 
of character in hexadecimal. Default = 07. 


Set end-of-record (carriage return) input -char- 
acter. Numeric value of character in hexa- 
decimal. Default = OD. 


Set end-of-file input character. Numeric value 
character in hexadecimal. Default = 1B. 


ACIA initialization value: sets parity, word 
size, and so forth. Value in hexadecimal. De- 
fault = 00. 


Reprint line character. Numeric value of char- 
acter in hexadecimal. 


Duplicate last input line character. Numeric 
value of character in hexadecimal. 


Pause character. Numeric value of character in 
hexadecimal. 


Abort character (normally CONTROL C). 
Numeric value of character in hexadecimal. 
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TSMON 


TSMON [devname | 


quit =h Quit character (normally CONTROL BE). 
Numeric value of character in hexadecimal. 


baud =d Set baud rate for software-controllable inter- 
face. Numeric code for baud rate: 0=110 
1=300 2=600 3=1200 4=2400 5=4800 
6 = 9600 7 = 19200 


Examples: 
tmode -upco lf null=4 pause (ENTER 


tmode Pag=24 pause bsl -echo 


bsp=8 (ENTER 


Note: If you use Tmode in a procedure file. It’s neces- 
sary to specify one of the standard output paths (.1 or 
.2), since the shell’s standard input path will have been 
redirected to the diskette file. (Tmode can be used on 
an SCFMAN-type devices only.) 


Example: 
tmode .1 pag=24 (ENTER 


This sets line/page on standard output. 


Supervises idle terminals and initiates the login sequence in 
timesharing applications. 


If you specify a device name, Tsmon opens standard I/O 
paths for the device. When you enter a carriage return, 
Tsmon automatically calls the Login command. If the login 
fails because the user can’t supply a valid user name or pass- 
word, control returns to Tsmon. 


Note: The Login command and its password file must 
be present for Tsmon to work correctly (see the Login 
command description). 
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UNLINK 


Logging Off the System 


Most programs will terminate when you enter an end-of-file 
marker ((CLEAR) (BREAK)) as the first character on a command 
line. This will log you off the system and return to Tsmon 
which will run Login again. 


Examples: 
tsmon /T18 (ENTER 
&: 805 


This will activate /T1, but must be run concurrently in order 
to keep /TERM active. 


UNLINK modname |... | 
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Tells OS-9 that the memory module(s) named are no longer 
needed by the user. 


OS-9 may (or may not) destroy the modules and reassign 
their memory depending on whether the module is in use by 
other processes. 


It’s good practice to unload modules whenever possible to 
make most efficient use of available memory resources. Mod- 
ules that have been Loaded and Linked may have to be Un- 
linked twice to remove them from memory. 


Warning: Never attempt to unlink a module you didn’t load 
or link. 


Examples: 


unlink Pgyml Pym5 PrymOD (CENTER 
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Unlinks the three modules specified. 


mdir (ENTER 


Module Directory at 11:26:22 


OSs OS59p26 INIT 
Boot CCDisk D@ 

Di D2 D3 
Cele TER TOMan 
RBF 9 oS SysGo 
C1 Shell RSZ232 
Ti PRINTER P 
PipeMan Piper Pipe 
Mdir 


unlink edit (CENTER 
mdir (ENTER 


Module Directory at Lli:27:22 


53 OS9r2 INIT 
Boot CCDisk De 

Di D2 ape. 
ia TERM TOMan 
RBF Sur SysGo 
Clock Shell RS2ce 
ta PRINTER P 
PireMan Piper Pipe 
MDir 


In this sequence, the Mdir command displays modules in 
memory. The next command specifies that the edit module be 
unlinked, and the output of the final command — Mdir — 
shows that the unlinking has been successful: edit no longer 
appears on the list. 


VERIFY 


VERIFY [ul 


Checks whether module header parity and CRC value of one 
or more modules on a file (standard input) are correct. 
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Module(s) are read from standard input, output is sent to stan- 
dard output, and messages are sent to the standard error path. 


Verify is dependent on the (<), input redirection command. 
If you fail to use the (<), redirection symbol, the Verify 
program will cause the system to lock. It is always necessary 
to redirect the input path. It is usually necessary to redirect 
the output and the error path. 


If you use the u (update) option, the module(s) are copied to 
the standard output path with the module’s header parity and 
CRC values replaced with verify’s computed values. You see 
a message indicating whether the module’s values match 
those computed by Verify. Verify, with the update option, 
will not set the execute flag in the file attributes. Use the Attr 
command to do this. 


If you don’t use the option, the module isn’t copied to stan- 
dard output. Verify simply displays a message indicating 
whether the module’s header parity and CRC match those 
computed by Verify. 


Note: Verify does not turn on execute flag or update 
file. Use Attr. 


verify u </DO/CMDS/edit +/D@/CMDS/ 
newedit (ENTER 


because the u option is used the edit module is copied to a 
new module, newedit, with the header parity and CRC values 
replaced with verify’s computed values. 


verify <EDIT *NEWEDIT (CENTER 


Module’s header Parity 15 correct, 
Calculated CRC matches module’s,. 


The program checks the edit module, and directs program 
output to a file called newedit. Since the u option wasn’t 
specified, Verify simply displays a summary message. 


verify tmyprogram2 (ENTER 


Module’s header Parity 15 correct, 
Calculated CRC matches module’s, 
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XMODE 


Checks the myprogram2 module. Since there’s no u in the 
command line, the module isn’t copied to standard output. 
Instead, a simple message is displayed. 


XMODE devname |paramiist| 


Displays or changes the initialization parameters of any SCF- 
type device such as the video display, printer, RS-232 port, 
and others. 


Common uses include changing baud rates and control key 
definitions. 


Xmode is similar to the Tmode command, but there are dif- 
ferences. Tmode operates only on open paths, so its effect is 
temporary. Xmode actually updates the device descriptor so 
the change persists as long as the computer is running, even 
if paths to the device are repeatedly opened and closed. 


If Xmode is used to change parameter(s) and the Cobbler 
program is used to make a new system disk or re-write sys- 
tem tracks on the current system disk, the changed parameter 
is permanently reflected on the new system disk. 


Xmode requires that you specify a device name. If you don't 
specify parameters, the present values for each parameter are 
displayed. You can use any number of parameters separating 
them by spaces or commas. 


XMODE parameter names: 


upc Upper-case only. Lower-case characters are 
automatically converted to upper-case. 


-upc Upper-case and lower case characters permit- 
ted. (default) 


bsb Erase on backspace: backspace characters 
echoed as a backspace-space-backspace se- 
quence (default). 
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-bsb 


bs] 


-bsl 


-If 


No erase on backspace: echoes single back- 
space only. 


Backspace over line. Lines are “‘deleted’’ by 
sending backspace-space-backspace sequences 
to erase the same line (for video terminals) 
(default). 


No backspace over line. Lines are “‘deleted’’ 
by printing a ‘‘new line’’ sequence (for hard- 
copy terminals). 


Input characters ‘‘echoed’’ back to terminal 
(default). 


No echo. 


Auto line feed on. Line feeds are automatically 
echoed to terminal on input and output carriage 
returns (default). 


Auto line feed off. 


pause Screen pause on: Output suspended upon full screen. 


-pause Screen 


null=n 


See pag parameter for definition of screen 
size. Resume output by typing any key. 


pause mode off. 


Set null count. Number of null ($00) charac- 
ters are transmitted after carriage returns for 
return delay. The number is decimal. Default 
= 0. 


Set video display page length to n (decimal) 
lines. Used for ‘‘pause’’ mode, see above. 


Set input backspace character. Numeric value 
of character in hexadecimal. Default = 08. 


Set output backspace character. Numeric value 
of character in hexadecimal. Default = 08. 


Set input delete line character. Numeric value 
of character in hexadecimal. Default = 18. 
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eof =h 


type=h 


reprint =h 


dup =h 


psc=h 


abort =h 


quit =h 


baud = d 


Examples: 


Set bell (alert) output character. Numeric value 
of character in hexadecimal. Default = 07. 


Set end-of-record (carriage return) input char- 
acter. Numeric value of character in hexa- 
decimal. Default = OD. 


Set end-of-file input character. Numeric value 
character in hexadecimal. Default = 1B. 


ACIA initialization value: sets parity, word 
size, and so forth. Value in hexadecimal. De- 
fault = 15. 


Reprint line character. Numeric value of char- 
acter in hexadecimal. 


Duplicate last input line character. Numeric 
value of character in hexadecimal. 


Pause character. Numeric value of character in 
hexadecimal. 


Abort character (normally CONTROL C). 
Numeric value of character in hexadecimal. 


Quit character (normally CONTROL E). 
Numeric value of character in hexadecimal. 


Set baud rate for software-controllable inter- 
face. Numeric code for baud rate: 0=110 
1=300 2=600 3=1200 4=2400 5=4800 
6 = 9600 7 = 19200 


xmode /TERM -uec lf null=4 bse=1F 
pause (ENTER 


xinode /Ti pag=24 Pause bsl -echo 


btsp=8 (ENTER 
xmode /P baud=3 -1f (ENTER 


119 


5@@ee@oeeeeeoeeeeeeeeeeeeeeeeeeeeeeeeeees 


Appendix A/Error Codes 


The error codes are shown in both hexadecimal (first column) 
and decimal (second column). Error codes other than those 
listed are generated by programming languages or user 
programs. 


OS-9 Error Codes 


HEX 


$02 


$03 


$C8 


$C9 


$CA 


$CB 


$CC 


$CD 


$CE 


DEC 


002 KEYBOARD INTERRUPT — The user 
used (BREAK) to abort a task that was cur- 
rently being executed. 


003 KEYBOARD INTERRUPT — The user 
used to cause the task to be 
executed as a background task with no 
video display, or to abort the task. 


200 PATH TABLE FULL — The file can’t be 
opened because the system path table is cur- 
rently full. 


201 ILLEGAL PATH NUMBER — Number 
too large, or for non-existent path. 


202 INTERRUPT POLLING TABLE FULL 


203 ILLEGAL MODE — Attempt to perform 
I/O function of which the device or file is 
incapable. 


204 DEVICE TABLE FULL — Can’t add 
another device. 


205 ILLEGAL MODULE HEADER — Module 
not loaded because its sync code, header 
parity, or CRC is incorrect. 


206 MODULE DIRECTORY FULL — Can’t 
add another module. 
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$D0 


$D1 


$D2 


$D3 


$D4 


$D5 


$D6 


$D7 


$D8 


$D9 


$DA 


$DD 


$DF 


SEO 


207 


208 


209 


210 


211 


ZZ 


Zhe 


214 


£2 be 


216 


paw 


218 


219 


pie 


224 


MEMORY FULL — Not enough con- 
tiguous RAM free. 


ILLEGAL SERVICE REQUEST — System 
call had an illegal code number. 


MODULE BUSY — Non-sharable module 
is in use by another process. 


BOUNDARY ERROR — Memory alloca- 
tion or deallocation request not on page 
boundary. 


END-OF-FILE — End-of-file encountered 
on read. 


RETURNING NON-ALLOCATED MEM- 
ORY — Attempted to deallocate. memory 
not previously assigned. 


NON-EXISTING SEGMENT — Device 
has damaged file structure. 


NO PERMISSION — File or device attri- 
butes don’t permit access requested. 


BAD PATHNAME — Syntax error in path- 
list, illegal character, for instance. 


PATH NAME NOT FOUND — Can’t find 
pathlist specified. 


SEGMENT LIST FULL — File is too frag- 
mented to be expanded further. 


FILE ALREADY EXISTS — Filename 
already appears in current directory. 


ILLEGAL BLOCK ADDRESS — Device’s 
file structure had been damaged. 


SUICIDE ATTEMPT — Request to return 
to memory where your stack is located. 


ILLEGAL PROCESS NUMBER — No 
such process exists. 
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$E5 


$SE6 


SE7 


$E8 


$E9 


SEA 


SEB 


$ED 


SEE 


SEF 


230 


231 


252 


230 


234 


250 


Fike # 


238 


259 


Device Driver Errors 


NO CHILDREN — Can’t wait because pro- 
cess has no children. 


ILLEGAL SWI CODE — Must be | to 3. 


PROCESS ABORTED — Process aborted 
by signal code 2. 


PROCESS TABLE FULL — Can’t fork 
now. 


ILLEGAL PARAMETER AREA — High 
and low bounds passed in fork call are 
incorrect. 


KNOWN MODULE — For internal use 
only. 


INCORRECT MODULE CRC — Module 
has bad CRC value. 


SIGNAL ERROR — Receiving process has 
previous unprocessed signal pending. 


NON-EXISTENT MODULE — Unable to 
locate module. 


BAD NAME — Illegal name syntax. 


RAM FULL — No free system RAM avail- 
able at this time. 


UNKNOWN PROCESS ID — Incorrect 
process ID number. 


NO TASK NUMBER AVAILABLE — All 
task numbers in use. 


The following error codes are generated by I/O device driv- 
ers, and are somewhat hardware-dependent. Consult manu- 
facturer’s hardware manual for more details. 
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$FO 


$F1 


$F2 


$F3 


$F4 


$F5 


$F6 


$F7 


$F8 


$F9 


$FA 


$FB 


$FC 


$FD 


240 


241 


242 


243 


244 


245 


246 


247 


248 


249 


250 


251 


252 


La 


UNIT ERROR — Device unit doesn’t exist. 


SECTOR ERROR — Sector number is out 
of range. 


WRITE PROTECT — Device is write- 
protected. 


CRC ERROR — CRC error on read or 
write verify. 


READ ERROR — Data transfer error dur- 
ing disk read operation, or SCF (terminal) 
input buffer overrun. 


WRITE ERROR — Hardware error during 
disk write operation. 


NOT READY — Device has ‘‘not ready’’ 
status. 


SEEK ERROR — Physical seek to non- 
existent sector. 


MEDIA FULL — Insufficient free space on 
media. 


WRONG TYPE — Attempt to read incom- 
patible media (for instance attempt to read 
double-side disk on single-side drive). 


DEVICE BUSY — Non-sharable device is 
in use. 


DISK ID CHANGE — Media was changed 
with files open. 


RECORD IS LOCKED-OUT — Another 
process is accessing the requested record. 


NON-SHARABLE FILE BUSY — Another 
process is accessing the requested file. 


@eeeeeacoeaecoaoooooaooeooooeoooooeooeo ooo eo eee eee eee 0 


p@e@eeeegeeeeeeeeeeeeeeeeeeeeeee ee eee & 


Appendix B/Display System 


Functions 


Color Computer OS-9 lets you use the video display in alpha- 
numeric, semigraphic, and graphic modes. There are many 
built-in functions to control the display. These functions are 
activated by various ASCII control characters. The three 
modes are therefore available for use by software written in 
any language using standard output statements (such as 
PRINT in BASIC). The Color Computer BASICO9 language 
has a Graphics Interface Module that can automatically gener- 
ate these codes using BASICO9 RUN statements. 


The display system has two display modes: Alphanumeric 
(‘‘Alpha’’) mode and Graphics mode. The Alphanumeric 
mode also includes ‘‘semigraphic’’ box-graphics. The Color 
Computer’s display system uses a separate memory area for 
each display mode so operations on the Alpha display do not 
affect the Graphics display, and vice-versa. Either display can 
be selected under software control. (See the Color Computer 
Manuals for more detailed information. ) 


Eight-bit characters sent to the display system are interpreted 
according to their numerical value, as shown in this chart: 


Character Range (Hex) Mode/Used For 


00 - OE Alpha Mode — Cursor and 
screen control. 

OF - 1B Graphics Mode — Drawing and 
screen control. 

IC - 20 Not used. 

20 - SF Alpha Mode — Upper case 
characters. 

60 - 7F Alpha Mode — Lower case 
characters. 

80 - FF Alpha Mode — Semigraphic 
patterns. 


The graphics and alphanumeric functions are handled by the 
OS-9 device driver module called CCIO. 
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Alpha Mode Display 


This is the standard operational mode. It’s used to display 
alphanumeric characters and semigraphic box graphics, and it 
simulates the operation of a typical computer terminal with 
functions for scrolling, cursor positioning, clear screen, line 
delete, and more. 


Each 8-bit character is assumed to be an ASCII character. It 
is displayed if its high order bit (sign bit) is cleared. Lower 


case letters are displayed in reverse video. If the high order 


bit of the character is set, it’s assumed to be a ‘‘Semigraphic 
6’’ graphics box. See the Color Computer manuals for an 
explanation of semigraphics functions. 


Alpha Mode Command Codes 
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Control 

Code Name/Function 

Ol HOME — Return cursor to upper left hand corner 
of screen. 

02 CURSOR XY — Move cursor to character X or 
line Y. The binary values minus 32 of the two 
characters following the control character are 
used as the X and Y coordinates. For example, to 
position the cursor at character 5 of line 10, you 
must give X= 37 and Y = 42. 

03 ERASE LINE — Erases all characters on the cur- 
sor line. 

06 CURSOR RIGHT — Move cursor right one char- 
acter position. 

08 CURSOR LEFT — Move cursor left one charac- 
ter position. 

09 CURSOR UP — Move cursor up one line. 

10 CURSOR DOWN — (Linefeed) move cursor 


down one line. 
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12 CLEAR SCREEN — Erase entire screen and 
home cursor. 

13 RETURN — Return cursor to leftmost character 
of line. 

14 DISPLAY ALPHA — Switch screen from 


graphic mode to alpha numeric mode. 


Graphics Mode Display 


Graphics mode is used to display high-resolution 2- or 4-color 
graphics. It includes commands to set color, plot and erase 
individual points, draw and erase lines, position the graphics 
cursor, and draw circles. 


The ‘“‘display graphics’” command must be executed before 
any other graphics mode command is used. It causes the 
graphics screen to be displayed and sets a current display for- 
mat and color. 


The first time the ‘‘display graphics’’ command is given, OS- 
9 allocates a 6144 byte display memory. So there must be at 
least that much continuous free memory available. (You can 
use the OS-9 Mfree command to check free memory.) This 
memory is retained until the ‘“‘end graphics’? command is 
given, even if the program that initiated Graphics mode 
finishes. It’s important that the ‘“‘end graphics’’ command be 
used to give up the display memory when Graphics mode is 
no longer needed. 


Graphics mode supports two basic formats: Two-color, which 
has 256 horizontal by 192 vertical points (G6R mode); and 
Four-color, which has 128-horizontal by 192 vertical points 
(G6C mode). Two color sets are available in either mode. 
Regardless of the resolution of the format selected, all 
Graphics mode commands use a 256 by 192 point coordinate 
system. The X and Y coordinates are always positive num- 
bers. Point 0, 0 is the lower lefthand corner of screen. 
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An invisible Graphics Cursor is used by many commands to 
reduce the amount of output required to generate graphics. 
You can explicitly set this cursor to any point by using the 
‘‘set graphics cursor’? command. Also, all other commands 
that include X, Y coordinates (such as ‘‘set point’’) move the 
graphics cursor to the specified position. 


Graphics Mode Selection Codes 


Code Format 
00 256 xX 192 two-color graphics 
01 128 x 192 four-color graphics 


Color Set And Current 
Foreground Color Selection Codes 


Two-Color Format Four-Color Format 
Char Background Foreground Background Foreground 


00 Black Black Green Green 
Color 01 Black Green Green Yellow 
Set 1 02 Green Blue 
03 Green Red 
04 Black Black Buff Buff 
Color 05 Black Buff Buff Cyan 
Set 1 06 Buff Magenta 
07 Buff Orange 
08 Black Black 
Color 09 Black Dark Green 
Set 1 10 Black Med. Green 
1] Black Light Green 
k2 Black Black 
Color ee, Black Green 
Set i 14 Black Red 
15 Black Buff 
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Graphics Mode Control Commands 


Control 
Code 


|e 


16 


Ly 


18 


19 


20 


Zi 


pips 


Name/Function 


DISPLAY GRAPHICS — Switches screen to 
graphics mode. This command must be given be- 
fore any other graphics commands are used. The 
first time this command is given, a 6K byte dis- 
play buffer is assigned. If 6K of contiguous mem- 
ory isn’t available, an error is returned. Fol- 
low this command by two characters specifying 
the graphics mode and current color/color set, 
respectively. 


PRESET SCREEN — Presets entire screen to 
color code passed in next character. 


SET COLOR — Selects foreground color (and 
color set) passed in next character, but doesn’t 
change graphics mode. 


END GRAPHICS — Disables graphics mode, re- 
turns the 6K byte graphics memory area to OS-9 
for other use, and switches to alpha mode. 


ERASE GRAPHICS — Erases all points to back- 
ground color and homes graphics cursor to the de- 
sired position. 


HOME GRAPHICS CURSOR — Moves 
graphics cursor to coordinates 0, 0 (lower left- 
hand corner). 


SET GRAPHICS CURSOR — Moves graphics 
cursor to given coordinates X, Y. The binary 
value of two characters that immediately follow 
are used as the X and Y values, respectively. 


DRAW LINE — Draws a line of the current fore- 
ground color from the current graphics cursor 
position to the given X, Y coordinates. The bi- 
nary value of the two characters that immediately 
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Zo 


24 


ZS 


26 


follow are used as the X and Y values, respec- 
tively. The graphics cursor is moved to the end 
point of the line. 


ERASE LINE Same as ‘‘draw line’’ except 
that the line is ‘‘drawn’’ in the current back- 
ground color, thus erasing the line. 


SET POINT — Sets the pixel at point X, Y to the 
current foreground color. The binary values of the 
two characters that immediately follow are used 
as the X and Y values, respectively. The graphics 
cursor is moved to the point set. 


ERASE POINT — Same as ‘‘draw point’’ except 
the point is “‘drawn’’ in the current background 
color, thus erasing the point. 


DRAW CIRCLE — Draws a circle of the current 
foreground color with its center at the current 
graphics cursor position using a radius R which is 
obtained using the binary value of the next char- 
acter. The graphics cursor position is not affected 
by this command. 


Get Status Commands 


Get Display Status: 
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The Color Computer I/O driver includes OS-9 ‘‘get status’’ 
commands that return the display status and joystick values, 
respectively. These are accessible via the BASICO9 Graphics 
Interface Module, or by the assembly language system calls 
listed below: 


Calling Format: Ida #1 (path number) 


Idb #SS.DStat (Getstat code $12) 
os9 ISGSTT Call OS-9 
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Passed: 


Returns: 


Get Joystick Values: 


Calling Format: 


Passed: 


Returns: 


nothing 


X = address of graphics display memory 

Y graphics cursor address X = MSB 
y=LSB 

A = color code of pixel at cursor address 


lda #1 (path number) 
ldb $SS.Joy (Getstat code $13) 
os9 ISGSTT call OS-9 


X = 0 for right joystick; 1 for left joystick 
X = selected joystick x value (0-63) 
Y = selected joystick y value (0-63) 
A = $FF if fire button on; $00 if off 


Display Control Codes Condensed Summary 


Ist Byte 


00 
Ol 
02 
03 


06 
08 
09 
10 


iW 
13 
14 
15 


2nd Byte 3rd Byte Function 


Null 
Home alpha cursor 


Column+32 Row+32_ Position alpha cursor 


Mode 


Erase line 


Cursor right 
Cursor left 
Cursor up 
Cursor down 


Clear screen 

Carriage return 

Select alpha mode 
Color Code Select graphics mode 
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16 
17 
18 
19 


20 
21 
rvs 
Zo 


24 
2 
26 


Color Code 
Color Code 


X Coord 
X Coord 
X Coord 


X Coord 
X Coord 
Radius 


Y Coord 
Y Coord 
Y Coord 


Y Coord 
Y Coord 


Preset screen 
Select color 

Quit graphics mode 
Erase screen 


Home graphics cursor 
Move graphics cursor 
Draw line to X/Y 
Erase line to X/Y 


Set point at X/Y 
Clear point at X/Y 
Draw circle 
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Appendix C/Keyboard Codes 


Key Definitions With Hexadecimal Values 


NORM SHFT CTRL NORM SHFT CTRL NORM SHFT CTRL 


030 O 30 — @40 60 NULOO P50 p70 DLE 10 
1 31 t 21 ae. Aa a 61 SOHO! Q51 q7l DCI 11 
(ae) eo: OO ~—B4e B62 SBTIKO? B52 eR Dep 
333 # 23 - 76 C43 c 63 ETX0O3 S53 s 73 #£DC 13 
434 $ 24 00 D44 $d 64 EOT04 T54 t 74 #&42DC4 14 
5 35 25 00 E45  e 6 EMD0S5 U55  u75 NAKI15 
6 36 & 26 00 F 46 f 66 ACK06 V56 v 76 SYN 16 
37° * 66 Gd? ¢ 67 BEL OF W57 wT ‘EIB 17 
8 38 ( 28 [5B H48  h 68 BSP 08 X58 x 78  CAN18 
939 ) 29 |] 5D 41 49 i 69 HT 09 Y59 y 79 EM 19 
: 3A * 2A 00 J 4A j 6A LF OA Z5A  z 7A SUMIA 
- 3B +2B 00 K4B  k 6B VT OB 
, 2 236 472 4e -1:6C Pr 0c 
—~2D =3D SF M4D m6D DR OD 
.2E >3E } 7D N4E- n6E CO OE 
, 3p: 2 3p AN 3C> -O4E -o- GER CE - OR 
Function Keys 
NORM SHFT CTRL 
BREAK 05 03 1B 
ENTER OD OD OD 
SPACE 20 20 20 
_ 08 18 10 
aa 09 19 1] 
¥ OA 1A [2 
A We ic 13 
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Appendix D/Keyboard Control 
Functions 


Key Definitions for Special Functions 


and Characters 


Key 
Combination 


CLEAR 
BREAK 
CLEAR) (— ) 


CLEAR) (_) 


CLEAR) (. ) 


CLEAR 


CLEAR 
CLEAR) (BREAK 


(—) 
SHIFT 


SHIFT) (BREAK 


CLEAR) (0 ) 


Control Function or Character 
Used a control key (CTRL). 
Same as (CLEAR) (CE). 


Generates an underline (__) character. The 
underline character is displayed as a left 
arrow ( > ). 


Generates a left brace ({) character. The left 
brace character is displayed as a left bracket 
({) in reverse video. 


Generates a right brace (}) character. The 
right brace character is displayed as a right 
bracket (]) in reverse video. 


Generates a tilde (~) character. The tilde is 
displayed as a hyphen (-) in reverse video. 


Generates a reverse slash (__) character. 


Generates an end-of-file (EOF). Same as 
(ESC) on a standard terminal. 


Backspace key or CONTROL H. 


Deletes the entire current line. Same as 
CONTROL X. 


Interrupts the video display of a running 
program. It reactivates the shell and then 
runs the program as a background task. 
Same as CONTROL C. 


Upper/lower case shift lock function. 
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CLEAR) (1 ) 


CLEAR 


CLEAR 
(CLEAR) (9) 
(CLEAR) (A) 
(CLEAR) (D) 


CLEAR) (E ) 


CLEAR) (W) 


Generates a vertical bar (|) character. The 
vertical bar character is displayed as an ex- 
clamation (!) mark in reverse video. 


Generates an up arrow or caret (*) charac- 
ter. 


Generates a left bracket ({) character. 
Generates a right bracket (]) character. 
Repeats previous command line. 


Redisplays current command line on the 
video display. 


Stops the program currently being executed. 
Same as BREAK. 


Temporarily halts output to the screen dis- 
play. Press any key to resume output. 
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INDEX 


Alpha Mode Display 
ATTR 
BACKUP 
BINEX 
BUILD 
Built-in Shell Commands 
CHX 
CHD 
CMDS Directory 
CMP 
COBBLER 
Color Selection Codes 
Color Set 
Commands 
Parameters 
Command Line Processing 
Command Separators 
Sequential Execution 
Concurrent Execution 
Pipes and Filters 
COPY 
Creating Processes 
DATE 
DCHECK 
DEFS Directory 
DEL 
DELDIR 
Device Driver Errors 
Device Names 
DIR 
Directories 
Creating 
Deleting 
Using 
Working 
DISPLAY 
Display System Functions 
DSAVE 
DUMP 
ECHO 
Error Codes 
Error Reporting 
EXBIN 


INDEX 
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Execution Modifiers 
Alternate Memory Size 
I/O Redirection 

File Attributes 

File Security 

File System 

File Usage 
Text Files 
Random-Access Data Files 
Executable Program Module Files 
Directories 
Miscellaneous 

FORMAT 

FREE 

Graphics Mode Control 

Graphics Mode Display 

IDENT 

Input/Output System 

Keyboard 
Shift Functions 
Control Functions 

Keyboard Codes 

Keyboard Control Functions 

KILL 

LINK 

LIST 

LOAD 

Loading Multiple Program 

Loading Program Modules 

LOGIN 

MAKDIR 

MDIR 

Memory Fragmentation 

Memory Management 

Memory Management Functions 

MERGE 

MFREE 

Multiprogramming 

Names 

OS-9BOOT 

OS-9 Error Codes 

OS-9 File System 
Organization 
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INDEX 


OS-9GEN 
Pathlists 
Printer 
PRINTERR 
Process States 


Processor Time Allocation 


PROCS 
PWD 
PXD 
RENAME 
RS-232 Port 
SAVE 
SETIME 
SEPA 
Shell 
Shell 
Shell Procedure Files 
SLEEP 
Startup File 
SYS Directory 
System Commands 
TEE 
Timesharing Systems 
Timeslicing 
TMODE 
TSMON 
UNLINK 
VERIFY 
Video Display 
Video Display Functions 
XMODE 
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